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,并检查版本。
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预期输出
0.40.7安装过程会产生额外下载日志,最后能输出 nvm 版本号即可。随后安装并启用最新 LTS,再比较 nvm 当前版本与 Node.js 实际版本。
nvm install --lts
nvm use --lts
nvm current
node --version预期输出
v<VERSION>
v<VERSION>两行版本应一致;下载和切换过程中的其他日志会因平台和具体版本不同而变化。
在 Windows 安装并切换
Windows 使用 nvm-windows。先从项目 Releases 下载 nvm-setup.exe 完成安装,关闭并重新打开 PowerShell,然后直接安装和启用 LTS。lts 是 nvm-windows 支持的版本别名。
nvm install lts
nvm use lts
node --version预期输出
v<VERSION>安装与切换时会有额外状态信息,最终 node --version 能返回版本号即可。若 nvm use lts 成功但 node 仍指向旧版本,执行 where.exe node 检查是否有旧安装目录排在 nvm 管理路径之前。
为项目记录明确版本
nvm-sh 会在项目目录向上查找 .nvmrc。如果团队需要完全复现,可把经过验证的完整版本写入文件,例如当前统一使用 24.21.0 时,.nvmrc 内容就是一行版本号。
24.21.0保存文件后,在项目根目录执行以下命令。nvm install 会按 .nvmrc 安装对应版本,已安装时会直接切换;nvm use 会再次确认当前 shell 使用该版本。
nvm install
nvm use
node --version预期输出
v24.21.0nvm-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”而更难判断。