拉了个新项目，npm install 直接报错，提示当前 Node 版本过低，要求 18 以上，本机还停在 14。这时候就得升级 node。别急着卸载重装，先把版本管理工具用起来，以后来回切换都方便。

先看清当前版本

命令行敲 node -v 和 npm -v 记下版本号。升级目标一般选 LTS 长期支持版，别追最新的奇数版本，稳定性差不少。

Windows 上两条路

  • 用 nvm-windows：先卸载现有 Node，装好 nvm-windows 后执行 nvm install 20.11.1，再 nvm use 20.11.1，一条命令切版本
  • 官网安装包：到 nodejs.org 下载 LTS 版 msi，双击覆盖安装，装完重开命令行验证 node -v

macOS 和 Linux 上用 nvm

依次执行 nvm install --lts、nvm use --lts、nvm alias default node，把默认版本钉在 LTS 上。装完如果命令不生效，多数是环境变量没加载，重开终端或者重新 source 一下配置文件。nvm 的好处是多版本共存，老项目跑 14、新项目跑 20，nvm use 来回切就行，用 nvm list 能看到本机装过哪些版本、当前用的是哪个。

升级后常遇到的问题

全局包装在旧版本目录下，新版本里找不到命令，重新 npm install -g 一遍即可。个别原生依赖需要重新编译，删掉 node_modules 和 lock 文件再装一般能解决。用 nvm 切换后 PATH 变了，VS Code 里的集成终端也要重启才能读到新路径，不然命令行和编辑器里版本对不上。

稳妥做法：生产服务器升级前，先在测试环境跑一遍完整构建和关键接口，确认依赖兼容没问题再动手。版本跟项目要求对齐，选 LTS 就好，不要为了新而新。