🧩 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-windows GitHub 下载地址】

选择最新版本的 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 路径加入系统环境变量中 👇

🪟 操作步骤:

  1. Win+S 搜索 “环境变量”,进入 “系统属性 → 环境变量”。
  2. 在系统变量中找到 Path,点击编辑。
  3. 添加你的 prefix 路径,例如:
D:\nvm\nodejs\node_globel
  1. 点击确定,保存设置。

🔁 建议重启终端(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