npm在特定PC上选择错误Node.js版本问题排查

环境与问题现象 #

• 本地用nvm管理Node.js，当前激活版本为18.19.0，未安装12.x版本；安装nvm前已彻底卸载Node，「添加或删除程序」中无残留
• 项目为Svelte开发的单页应用，进入项目目录后：
  • 直接执行node -v返回18.19.0
  • 执行npm run nodever返回12.20.0（项目脚本配置为"nodever": "node -v"）
  • 执行yarn run nodever返回18.19.0
  • 所有场景下npm版本均为10.2.5，升级至10.7.0后问题依旧

工作PC上npm会选择未安装的Node版本，导致构建、测试脚本异常；但同一项目在全新虚拟机及CI/CD流水线中使用npm可正常调用正确版本，说明问题出在本地配置。

已尝试的修复操作 #

• 从Git重新拉取项目到新文件夹无效
• 重装nvm，安装/卸载Node 12版本后无效
• 检查PATH变量，仅包含nvm相关路径，无可疑内容
• 执行npm cache clean --force无效
• 全局升级npm到最新版（10.7.0）无效

核心疑问 #

哪些配置可能导致该问题？npm为何会选择错误的Node版本？（注：yarn无异常，需排查npm专属问题）

附账号及系统PATH变量 #

账号PATH #

%NVM_HOME%;%NVM_SYMLINK%;C:\Users\1\AppData\Local\Microsoft\WindowsApps;C:\Program Files\kdiff3;C:\Users\1\AppData\Local\GitHubDesktop\bin;C:\Nuget;C:\Users\1\AppData\Local\Programs\Fiddler;C:\Users\1.dotnet\tools;%USERPROFILE%\AppData\Local\Microsoft\WindowsApps;C:\Python27;C:\Python38;%USERPROFILE%.dotnet\tools;C:\Users\1\AppData\Local\Yarn\bin;%JetBrains Rider%;%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code Insiders\bin;

系统PATH #

%NVM_HOME%;%NVM_SYMLINK%;C:\Python311\Scripts;C:\Python311;C:\Python310\Scripts;C:\Python310;C:\Python39\Scripts;C:\Python39;C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin;C:\Python38\Scripts;C:\Python38;C:\Python27;C:\Python27\Scripts;C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\WINDOWS\System32\OpenSSH;C:\ProgramData\chocolatey\bin;C:\Program Files\Microsoft SQL Server\130\Tools\Binn;C:\Program Files\Microsoft VS Code\bin;C:\Program Files (x86)\Microsoft SQL Server\Client SDK\ODBC\130\Tools\Binn;C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn;C:\Program Files (x86)\Microsoft SQL Server\140\DTS\Binn;C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio;C:\Nuget;C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\130\Tools\Binn;C:\Program Files\Microsoft SQL Server\140\Tools\Binn;C:\Program Files\Microsoft SQL Server\140\DTS\Binn;C:\Users\1\AppData\Local\GitTfs;C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\170\Tools\Binn;C:\Program Files\Microsoft SQL Server\110\Tools\Binn;C:\Program Files (x86)\Microsoft SQL Server\110\Tools\Binn;C:\Program Files\Microsoft SQL Server\110\DTS\Binn;C:\Program Files\PuTTY;C:\Program Files (x86)\Yarn\bin;C:\Program Files\Microsoft\Azure Functions Core Tools;C:\Program Files\Microsoft SQL Server\150\Tools\Binn;C:\Program Files\dotnet;C:\Program Files\Docker\Docker\resources\bin;C:\Program Files (x86)\GitExtensions;C:\Program Files\Git\cmd;C:\WINDOWS\System32\WindowsPowerShell\v1.0;C:\Program Files\PowerShell\7;C:\Program Files (x86)\PowerShell\7;

可能的配置问题及原因分析 #

1. npm scripts-shell配置异常：npm默认使用系统默认shell，若配置了自定义shell，且该shell环境变量残留旧Node 12路径，会导致脚本执行时调用错误版本。执行npm config get scripts-shell查看配置，若非默认值，重置为系统默认（Windows下可设为cmd.exe或powershell.exe）。
2. 项目本地npm配置/缓存残留：项目根目录的.npmrc可能有自定义配置，或者node_modules/.bin残留旧Node相关执行文件。删除项目.npmrc、node_modules及package-lock.json后，重新执行npm install测试。
3. nvm软链接损坏：nvm通过%NVM_SYMLINK%指向当前激活的Node版本，若该软链接指向旧Node 12路径（即使已卸载），npm执行脚本会读取错误路径。手动检查%NVM_SYMLINK%实际指向，以管理员身份执行nvm use 18.19.0刷新软链接。
4. Windows环境变量优先级/延迟加载问题：用户PATH与系统PATH可能存在优先级冲突，或第三方工具终端加载了旧Node路径。在全新终端窗口执行操作，检查全局%USERPROFILE%\.npmrc是否有node_execpath配置强制指定Node版本。
5. 全局npm包残留影响：某些全局包可能硬编码Node路径或修改npm执行逻辑。执行npm list -g --depth=0查看全局包，临时卸载所有全局包后测试问题是否消失。

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