🧩 NVM(Windows)使用教程:多版本 Node.js & npm 管理利器
在 Web 开发或 Node.js 项目中,你是否遇到过这些问题?
- 项目 A 使用 Node.js v14.x,项目 B 却需要 v18.x?
- 多次卸载重装 Node.js 管理混乱?
- npm 全局包太大,占用 C 盘空间?
🎯 NVM(Node Version Manager)正是为了解决这些问题而存在。
本文将手把手带你在 Windows 下使用 NVM 管理 Node.js 和 npm 的多个版本,并进行全局路径优化与国内源配置。
📥 1. 安装 NVM(Windows 版)
💡 本教程适用于 Windows 操作系统。Linux/macOS 用户请使用原版 nvm(参考 nvm-sh/nvm)。
下载安装程序:
选择最新版本的 nvm-setup.exe 下载并安装即可。
安装完成后,在 nvm 安装目录(如 D:\nvm)内找到并编辑 settings.txt,添加国内镜像加速配置 ⬇️
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
🔧 2. NVM 常用命令速览
命令 | 说明 |
---|---|
nvm -v | 查看当前 nvm 版本 |
nvm list | 显示已安装 Node.js 版本列表 |
nvm install 版本号 | 安装指定版本(如:nvm install 14.20.1) |
nvm use 版本号 | 切换 node 使用版本 |
nvm on / nvm off | 开启/关闭 NVM 管理 |
nvm uninstall 版本号 | 卸载指定 Node.js 版本 |
nvm root | 查看当前 Node.js 安装路径 |
📌 示例:
nvm install 18.17.0
nvm use 18.17.0
📁 3. 配置 npm 全局路径(释放 C 盘空间)
🧹 默认 npm 全局包安装在 C 盘用户目录:
C:\Users\用户名\AppData\Roaming\npm
为了优化磁盘使用,可将其修改为自定义目录(如放到 D 盘中):
🛠 执行以下命令设置路径:
# 设置全局安装路径
npm config set prefix "D:\nvm\nodejs\node_globel"
# 设置缓存存储路径(大体积缓存包)
npm config set cache "D:\nvm\nodejs\node_cache"
⚙️ 查看配置是否生效:
npm config ls
完成后建议手动创建以下两个文件夹(防止安装时报错):
- D:\nvm\nodejs\node_globel
- D:\nvm\nodejs\node_cache
🛠 4. 配置环境变量(prefix 路径)
为了让全局安装的 npm 包可以在任何目录运行,需要将上面设置的 prefix 路径加入系统环境变量中 👇
🪟 操作步骤:
- Win+S 搜索 “环境变量”,进入 “系统属性 → 环境变量”。
- 在系统变量中找到 Path,点击编辑。
- 添加你的 prefix 路径,例如:
D:\nvm\nodejs\node_globel
- 点击确定,保存设置。
🔁 建议重启终端(PowerShell/CMD/VSCode)或计算机,确保环境变量生效。
🌐 5. 更换 npm 国内镜像源(加速 npm 安装)
由于网络原因,访问国外源可能非常慢。建议将 npm 源替换为国内镜像(如淘宝的 npmmirror)。
执行以下命令 ⬇️
# 查看当前 registry URL
npm config get registry
# 设置为国内源(中科大源也可)
npm config set registry https://registry.npmmirror.com
💡 验证是否生效:
npm config get registry
# 正常输出应为: https://registry.npmmirror.com
✅ 验证安装状态
在配置完成后,你可以执行以下命令检查一切是否正常运行:
node -v # 检查 node 是否能正常运行
npm -v # 检查 npm 是否可用
nvm list # 查看 node 版本安装状态
🧾 总结:一个高效开发环境这样配置 ✅
工具 | 功能 |
---|---|
nvm | 管理多个 Node.js & npm 版本 |
prefix | 设置全局包安装目录 |
cache | 设置临时缓存目录 |
Path 环境变量 | 确保全局包可全局访问 |
registry | 更换 npm 国内镜像提升速度 |
🎉 到这里你已经成功掌握使用 NVM 管理 Node.js 和 npm 的全部技能,不再为「版本冲突」和「C盘爆满」而烦恼!
作者:freed 创建时间:2025-03-28 14:14
最后编辑:freed 更新时间:2025-03-28 14:19
最后编辑:freed 更新时间:2025-03-28 14:19