如何升级 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 版本。在测试环境使用项目规定的安装与构建流程,检查原生依赖、自动化测试及实际服务启动。保留旧版本或旧镜像作为回滚路径,再进行生产发布。

参考资料

参考资料

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台