如何升级 Node.js 和 npm 到最新版本
按已有安装方式升级 Node.js,区分 LTS 与 Current,检查 npm engines 兼容性,并验证项目依赖、构建和回滚路径。
先确认当前 Node.js 来自哪里,再选择同一套工具升级。 开发机适合使用版本管理器切换版本,生产环境应选择仍受支持、且通过项目测试的版本,不能只追求版本号最新。
检查当前安装
node --version
npm --version
# Linux/macOS
command -v node
command -v npm
# Windows PowerShell
Get-Command node
Get-Command npm
如果由系统包管理器、Homebrew、版本管理器或容器镜像管理,沿用对应方式更新,避免多套 Node.js 路径互相覆盖。
使用 nvm(Linux/macOS)
已安装 nvm 时,可以安装并切换到 LTS:
nvm install --lts
nvm use --lts
nvm alias default 'lts/*'
node --version
npm --version
需要 Current 版本做兼容性验证时,使用 nvm install node。团队项目建议通过 .nvmrc 固定版本,再执行 nvm install 与 nvm use。
Windows 和 macOS 的其他安装方式
Windows 可以使用 Node.js 官方安装包,或按 nvm-windows 的文档管理多版本。nvm-windows 与 Unix 的 nvm 是不同项目,参数并不完全一致。
macOS 若原先用 Homebrew 安装,应先确认使用的 formula,再通过 Homebrew 更新。不要一边使用 Homebrew,一边往同一路径叠加其他全局安装工具。
是否需要单独升级 npm
Node.js 通常自带匹配的 npm。确需升级时,先检查目标 npm 的 Node.js 版本要求:
npm view npm@latest engines
确认兼容后再执行 npm install --global npm@latest,或安装项目约定的版本。版本管理器中的全局包通常按 Node.js 版本隔离,迁移后需要重新确认。
项目验证与回滚
升级前记录 Node.js、npm 和 lockfile 版本。在测试环境使用项目规定的安装与构建流程,检查原生依赖、自动化测试及实际服务启动。保留旧版本或旧镜像作为回滚路径,再进行生产发布。