Outdated "Upgrading on Windows" - obsolete workarounds?
Nobody has claimed this yet.
- Dominant language
- MDX
- Stars
- 712
- Forks
- 4.2k
- Avg merge
- 4d 16h
- Merged PRs (30d)
- 3
Description
Description
In a 64-bit Node.js installation on Windows 11 25H2,
C:\Program Files\nodejs\is added to the system PATH environment variableC:\Users\%USERNAME%\AppData\Roaming\npmis added to the user PATH environment variable
and the system PATH takes precedence over the user PATH. This is correctly described.
The statement:
... it will always use the version of npm installed with node instead of the version of npm you installed using
npm -g install npm@<version>.
does not hold true for Node.js 26.4.0, nor for the lowest currently supported Node.js 22.33.1.
The workarounds that are described, appear to be unnecessary and obsolete.
Steps to reproduce
- Install https://nodejs.org/dist/v26.4.0/node-v26.4.0-x64.msi with bundled npm 11.17.0 on Windows 11 25H2
- In a cmd command terminal window execute
echo %PATH%and confirm the priority is:C:\Program Files\nodejs\C:\Users\%USERNAME%\AppData\Roaming\npm
- Execute
npm --versionand confirm that the version shown is11.17.0 - Execute
npm install npm@11.18.0 -g - Execute
npm --versionand confirm that the version shown is11.18.0 - Repeat
npm --versionin the following and confirm they also show npm11.18.0- Windows PowerShell 5.1
- PowerShell 7.6.3
- Git Bash
Repeat for Node.js 22.33.1 with bundled npm 10.9.8. Update to npm@11.18.0.
Suggested solution
Review and revise the documentation section for accuracy regarding currently supported versions of Node.js 22, 24 & 26.
URL
https://docs.npmjs.com/try-the-latest-stable-version-of-npm#upgrading-on-windows
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at the “Upgrading on Windows” section of the linked npm documentation page and review its statements against the reported Node.js 22, 24, and 26 behavior. Verify the documented commands and workarounds on Windows, then revise the section so it accurately reflects current supported versions and remove obsolete guidance.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- node.js
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100