Node.js / 系统课时

使用版本管理工具

使用版本管理工具

当多个项目需要不同 Node.js 版本时,反复卸载重装很容易污染 PATH,也难以复现团队环境。本节使用常见版本管理工具完成 LTS 安装、版本切换、项目版本记录与旧版本清理。

学习目标

  • 在 macOS/Linux 与 Windows 上选择对应的 Node.js 版本管理工具。
  • 安装、切换并验证不同 Node.js 版本,并为项目记录明确版本。

先区分两套 nvm

macOS/Linux 常用的是 nvm-sh/nvm,Windows 原生环境常用的是 nvm-windows。它们名称相近但不是同一个项目,部分命令参数也不同,最典型的差异是前者使用 nvm install --lts,后者使用 nvm install lts。

环境 工具 安装 LTS 切换 LTS
macOS/Linux nvm-sh nvm install --lts nvm use --lts
Windows nvm-windows nvm install lts nvm use lts

Windows 如果已经用 MSI/EXE 单独安装过 Node.js,建议先卸载独立安装版本,再装 nvm-windows,避免旧 PATH 或符号链接与版本管理器冲突。macOS/Linux 则应确认当前 shell 能加载 nvm 初始化脚本。

在 macOS/Linux 安装并切换

下面示例适用于 nvm-sh 0.40.7。安装脚本会尝试把 nvm 初始化配置写入当前用户的 shell 配置文件;执行后立即加载 nvm,并检查版本。

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.7/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
nvm --version

预期输出

text
0.40.7

安装过程会产生额外下载日志,最后能输出 nvm 版本号即可。随后安装并启用最新 LTS,再比较 nvm 当前版本与 Node.js 实际版本。

bash
nvm install --lts
nvm use --lts
nvm current
node --version

预期输出

text
v<VERSION>
v<VERSION>

两行版本应一致;下载和切换过程中的其他日志会因平台和具体版本不同而变化。

在 Windows 安装并切换

Windows 使用 nvm-windows。先从项目 Releases 下载 nvm-setup.exe 完成安装,关闭并重新打开 PowerShell,然后直接安装和启用 LTS。lts 是 nvm-windows 支持的版本别名。

powershell
nvm install lts
nvm use lts
node --version

预期输出

text
v<VERSION>

安装与切换时会有额外状态信息,最终 node --version 能返回版本号即可。若 nvm use lts 成功但 node 仍指向旧版本,执行 where.exe node 检查是否有旧安装目录排在 nvm 管理路径之前。

为项目记录明确版本

nvm-sh 会在项目目录向上查找 .nvmrc。如果团队需要完全复现,可把经过验证的完整版本写入文件,例如当前统一使用 24.21.0 时,.nvmrc 内容就是一行版本号。

text
24.21.0

保存文件后,在项目根目录执行以下命令。nvm install 会按 .nvmrc 安装对应版本,已安装时会直接切换;nvm use 会再次确认当前 shell 使用该版本。

bash
nvm install
nvm use
node --version

预期输出

text
v24.21.0

nvm-windows 不使用 nvm-sh 的 .nvmrc 工作流时,可以在项目 README 或团队环境文档中记录完整版本,并显式执行 nvm use 24.21.0。不要只写“使用 LTS”,否则几个月后新 LTS 发布,开发机和 CI 可能解析到不同版本。

维护旧版本与排查切换问题

版本升级后先用 nvm ls(nvm-sh)或 nvm list(nvm-windows)查看已安装版本,确认没有项目依赖旧版后再执行 nvm uninstall <VERSION>。切换版本后,全局 npm 包不应被默认视为“已经迁移”,可用 npm list -g --depth=0 检查当前版本下实际可用的全局工具。

如果 nvm current 或 node --version 与预期不一致,定位顺序固定为:先确认当前终端已经加载 nvm,再检查 node 实际路径,最后检查 shell 配置或 Windows PATH 中是否残留独立安装。不要同时用多套版本管理器接管同一个开发环境,否则问题会从“版本没切换”变成“谁在最后改 PATH”而更难判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用版本管理工具

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通