基础前提
先确认 nvm 安装成功:
Windows:在命令提示符 / 终端输入 nvm version
macOS/Linux:输入 nvm --version
能输出版本号即安装成功。
nvm 核心使用命令
1. 查看可安装的 Node.js 版本(找想要的版本)
# 列出所有可安装的Node.js版本(包含历史版本) nvm list available # Windows 简写 nvm ls available
执行后会显示版本列表,比如 20.11.0、18.19.0 等,LTS 表示长期支持版(推荐生产环境用)。
2. 安装指定版本的 Node.js
# 安装指定版本(例:安装20.11.0版本) nvm install 20.11.0 # 安装最新LTS版(长期支持版,推荐) nvm install lts/* # Windows 若安装失败,可指定架构(32/64位) nvm install 20.11.0 64
⚠️ 关键:安装后不会自动切换到该版本,需手动切换。
3. 查看已安装的 Node.js 版本
# 列出本地已安装的所有Node.js版本 nvm list # 或 nvm ls(简写)
执行后会显示已安装版本,带 * 号的是当前正在使用的版本。
4. 切换 / 使用指定版本的 Node.js
# 切换到已安装的指定版本(例:切换到20.11.0) nvm use 20.11.0 # Windows 切换时若提示权限不足,需以管理员身份运行终端/命令提示符
切换后,输入 node -v 验证:会显示当前使用的 Node.js 版本号,说明切换成功。
5. 设置默认 Node.js 版本(重启终端仍生效)
# 将指定版本设为默认版本(例:设20.11.0为默认) nvm alias default 20.11.0 # 验证默认版本:重启终端,输入 node -v,显示设置的版本
6. 卸载指定版本的 Node.js
# 卸载不需要的版本(例:卸载18.19.0) nvm uninstall 18.19.0
实用进阶配置(加速下载)
默认下载 Node.js 可能较慢,可配置国内镜像(淘宝源):
Windows 系统
找到 nvm 安装目录(默认 C:\Users\你的用户名\AppData\Roaming\nvm);
编辑目录下的 settings.txt 文件,添加两行:
node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/
macOS/Linux 系统
在终端执行以下命令(临时生效,重启终端需重新执行):
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
若想永久生效,可将上述命令添加到 ~/.bashrc 或 ~/.zshrc 文件中。
常见使用场景示例
# 1. 安装18.x LTS版 nvm install 18 # 2. 切换到18.x版本 nvm use 18 # 3. 查看当前使用版本 node -v # 输出 v18.19.0 # 4. 切回20.x版本 nvm use 20
总结
核心流程:查看可安装版本 → 安装版本 → 切换版本 → 验证版本;
常用命令:nvm install(安装)、nvm use(切换)、nvm list(查看)、nvm alias default(设默认);
配置国内镜像可解决 Node.js 下载慢的问题,Windows 改 settings.txt,macOS/Linux 设环境变量。
如果遇到切换版本失败、权限不足等问题,都可以告诉我,我会帮你排查。