Windows安装Node v16.15.1后npm无法从8.4.0升级到8.11.0

问题根因 #

该异常由两类问题共同导致：

1. Chocolatey安装脚本生成的旧版npm软链接优先级高于Node.js安装目录自带的npm程序，系统优先调用了残留的npm 8.4.0版本，而非Node v16.15.1默认内置的npm 8.11.0
2. 残留的8.4.0版本npm未适配新的参数规范，执行命令时会弹出--global、--local参数废弃的警告，还会引发全局包安装路径错乱等使用异常。

修复步骤 #

• 第一步：定位冲突文件路径
  打开任意终端（CMD/PowerShell均可），执行where npm命令，输出结果中会列出系统所有可被调用的npm程序路径：正常情况下Node安装目录下的C:\Program Files\nodejs\npm.cmd应排在首位；如果首位是Chocolatey路径下的C:\ProgramData\chocolatey\bin\npm.cmd，即可确认是路径优先级+残留文件问题。
• 第二步：删除Chocolatey残留的npm软链接
  打开资源管理器进入Chocolatey的bin目录（默认路径为C:\ProgramData\chocolatey\bin），找到并删除以下4个文件：
  • npm
  • npm.cmd
  • npx
  • npx.cmd
    上述文件均为旧版本安装时生成的跳转软链接，删除不会影响Node.js自带的npm、npx组件。
• 第三步：同步npm版本消除参数警告
  关闭所有已打开的终端窗口，重新以管理员身份启动PowerShell，执行以下命令安装对应版本的npm：

  npm install npm@8.11.0 --location=global
  

  这里直接使用--location=global参数，可绕过旧版本残留导致的参数废弃警告。
• 第四步：校验修复结果
  关闭管理员终端，重新打开普通权限终端，依次执行版本查询命令：
  1. 执行node -v，确认输出为v16.15.1
  2. 执行npm -v，确认输出为8.11.0，且无参数废弃警告弹出，即为修复完成。

兜底处理方案 #

如果完成上述操作后异常仍然存在，手动调整系统环境变量优先级即可：

1. 按下Win+R组合键，输入sysdm.cpl回车打开系统属性面板
2. 切换到「高级」选项卡，点击「环境变量」按钮
3. 在「系统变量」列表中找到Path项，双击打开编辑页
4. 将Node.js安装路径（默认值为C:\Program Files\nodejs\）的排序上移，确保其位置高于Chocolatey的bin路径（C:\ProgramData\chocolatey\bin）
5. 保存所有设置后重启终端，异常即可解决。

内容的提问来源于stack exchange，提问作者Munchkin