🧰 使用 NVM 管理 Node.js 版本 —— 安装与切换教程
NVM(Node Version Manager)是一个用于管理 Node.js 版本的工具,支持多版本共存、快速切换、无需管理员权限,非常适合前端开发者使用。
📦 一、NVM 安装
💻 Windows 安装(推荐使用 nvm-windows)
步骤:
-
打开 GitHub 地址:https://github.com/coreybutler/nvm-windows/releases
-
下载最新版
nvm-setup.exe
安装包 -
双击安装,建议安装路径不要带空格或中文(如:
C:\nvm
) -
安装完成后,打开终端输入以下命令测试:
nvm version
若显示版本号,则安装成功 ✅
🐧 macOS / Linux 安装
使用 curl
安装(推荐):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
或者使用 wget
:
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
然后执行:
# 加载配置(或重启终端)
source ~/.bashrc # bash 用户
source ~/.zshrc # zsh 用户
验证安装:
nvm -v
出现版本号说明安装成功 ✅
📥 二、安装 Node.js 版本
nvm install 18.18.0 # 安装 Node.js v18.18.0
nvm install 16.20.2 # 安装 Node.js v16.20.2
NVM 会自动下载并安装对应版本的 Node.js,同时隔离环境。
🔄 三、切换 Node.js 版本
nvm use 18.18.0 # 切换到 Node.js v18.18.0
nvm use 16.20.2 # 切换到 Node.js v16.20.2
切换后,可以通过以下命令查看当前使用版本:
node -v
📌 四、设置默认版本(开机默认使用)
nvm alias default 18.18.0
下次打开终端时自动使用这个版本。
📚 五、常用命令汇总
命令 | 说明 |
---|---|
nvm install <version> |
安装指定版本 |
nvm uninstall <version> |
卸载指定版本 |
nvm list 或 nvm ls |
查看已安装的 Node 版本 |
nvm use <version> |
切换 Node 版本 |
nvm alias default <version> |
设置默认版本 |
node -v |
查看当前 Node 版本 |
nvm current |
显示当前正在使用的版本 |
🧹 六、常见问题
❓nvm 安装成功但无法使用?
-
确保配置文件(如
.bashrc
或.zshrc
)中已正确加载 NVM 初始化脚本 -
重启终端或执行
source ~/.bashrc
再尝试
❓安装失败 / 下载缓慢?
-
使用淘宝镜像(适用于中国大陆):
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install 18.18.0
✅ 总结
NVM 是开发者管理 Node.js 多版本环境的神器,特别适用于需要在不同项目中切换 Node 版本的场景。掌握 NVM,可以让你的开发环境更加灵活、稳定。
如果你需要这份文档输出成:
-
✅ Markdown 文件
-
✅ PDF 格式文档
-
✅ 技术文档网站风格(如 VuePress) 我也可以帮你生成,告诉我你要哪种格式就行~
感谢您的来访,获取更多精彩文章请收藏。

THE END