升级到指定Node.js版本时npm安装成功但版本未更新如何处理

错误原因 #

你使用的升级方法本身存在问题：npm 是 Node.js 自带的包管理工具，依赖 Node.js 环境运行，通过 npm install -g node@14.17.1 安装 Node.js，只会将 Node.js 作为普通 npm 全局包安装到 npm 全局包目录下，不会替换系统当前默认的 Node.js 执行文件路径。由于系统默认 Node.js 安装路径的环境变量优先级高于 npm 全局包目录，因此执行 node -v 时依旧会读取旧版本。

正确升级方案 #

Windows 系统 #

• 直接下载 14.17.1 版本的 Node.js 官方安装包，双击运行后覆盖原有安装即可，完成后重启终端执行 node -v 验证版本。
• 若你使用 Chocolatey 包管理器，可直接执行 choco install nodejs --version=14.17.1 完成指定版本安装。

macOS / Linux 系统 #

推荐使用 Node.js 版本管理工具完成升级，避免多版本路径冲突：

• 若使用 n 版本管理工具：先执行 npm install -g n 安装工具，再执行 n 14.17.1 即可自动完成指定版本的安装与切换，重启终端后执行 node -v 验证即可。
• 若使用 nvm 版本管理工具：执行 nvm install 14.17.1 安装对应版本后，再执行 nvm use 14.17.1 即可切换到目标版本。

临时生效方案（不推荐长期使用） #

如果你暂时不想修改现有安装配置，可将 npm 全局包的可执行文件目录提升至环境变量最高优先级：

• 若使用 bash 终端，执行 echo 'export PATH=$(npm prefix -g)/bin:$PATH' >> ~/.bashrc && source ~/.bashrc 即可生效。
• 若使用 zsh 终端，执行 echo 'export PATH=$(npm prefix -g)/bin:$PATH' >> ~/.zshrc && source ~/.zshrc 即可生效。

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