WORTHY BLOG

外观

NVM 安装与 WebStorm 配置全指南

约 1011 字大约 3 分钟

2025-12-29

在前端开发中，我们经常面临一个头疼的问题：老项目依赖 Node v14，新项目需要 Node v18，甚至还想尝鲜 Node v20。手动反复卸载安装 Node.js 极其低效且容易出错。

本文将手把手教你在 Windows 系统下使用 NVM (Node Version Manager) 优雅地管理多个 Node 版本，并解决 WebStorm 中的配置问题。

⚠️ 第一步：彻底清理旧环境（至关重要）

在安装 NVM 之前，必须彻底卸载电脑上现有的 Node.js 版本，否则会导致路径冲突，使得版本切换失效。

  1. 打开 设置 -> 应用 -> 安装的应用，找到 Node.js 并卸载。
  2. 检查并删除以下残留文件夹（如果存在）：
  • C:\Program Files\nodejs
  • C:\Program Files (x86)\nodejs
  • C:\Users\<你的用户名>\AppData\Roaming\npm
  • C:\Users\<你的用户名>\AppData\Roaming\npm-cache

🚀 第二步：下载与安装 NVM

  1. 下载安装包 前往 GitHub 发布页下载最新版：nvm-windows releases

推荐下载 nvm-setup.exe 或 nvm-setup.zip。

  1. 安装配置
  • 双击运行安装程序。
  • 安装路径建议：建议修改默认路径，避免路径中包含空格（如 Program Files），推荐安装在根目录下，例如：
  • NVM 目录：D:\nvm
  • Node Symlink 目录：D:\nodejs
  1. 验证安装 打开 CMD 或 PowerShell，输入：
nvm version

如果出现版本号（如 1.1.12），说明安装成功。

⚡ 第三步：配置国内镜像（加速下载）

默认源在国外，下载速度极慢。建议安装后立即配置国内镜像源。

在命令行中依次执行：

# 设置 Node 镜像
nvm node_mirror https://npmmirror.com/mirrors/node/

# 设置 npm 镜像
nvm npm_mirror https://npmmirror.com/mirrors/npm/

🛠 第四步：常用命令速查表

以下是日常开发中最常用的指令流程：

1. 查看可安装版本

nvm list available

2. 安装特定版本

nvm install 18.16.0
# 或者安装最新的长期支持版
nvm install lts

3. 查看已安装版本

nvm list

4. 切换使用版本（关键）

注意：执行此命令通常需要管理员权限（右键 CMD/PowerShell -> 以管理员身份运行）。

nvm use 18.16.0

5. 验证环境

node -v
npm -v

💻 第五步：WebStorm 配置与清理

很多开发者在 WebStorm 中会遇到 Node 版本混乱的问题，这里统一说明如何配置及清理。

1. 正确配置 WebStorm 的 Node 解释器

为了让 WebStorm 跟随你系统 nvm use 的版本自动切换：

  1. 打开设置：File -> Settings -> Languages & Frameworks -> Node.js。
  2. 在 Node interpreter 栏中，选择 NVM 创建的快捷方式路径（Symlink）。
  • 通常是：C:\Program Files\nodejs\node.exe 或者你自定义的 D:\nodejs\node.exe。
  • 不要直接选具体版本号的路径（如 D:\nvm\v18.16.0\node.exe），否则你用 NVM 切换版本后，WebStorm 依然会锁死在旧版本。

2. 如何删除 WebStorm 中不需要的 Node 版本？

如果你在 WebStorm 的解释器下拉列表中看到了一堆不再使用的版本：

  • 只是想清理列表（移除引用）： 点击 Node interpreter 右侧的 ... 按钮，选中不想要的版本，点击 - (减号) 移除。这不会删除文件，只是让 IDE 忘记它。
  • 彻底删除某个 Node 版本（释放硬盘空间）： 不要在 WebStorm 里删，请使用 NVM 命令：
nvm uninstall <版本号>
# 例如：nvm uninstall 14.20.0

❓ 常见问题 FAQ

Q: 执行 nvm use 报错 "Access is denied"？A: 权限不足。请务必右键点击终端图标，选择“以管理员身份运行”。

Q: 切换版本后，刚才安装的 yarn 或 vue-cli 不见了？A: 这是正常的。NVM 中每个 Node 版本的全局包（Global Packages）是相互隔离的。切换到新版本后，需要重新安装该版本所需的全局包。

Q: 下载 Node 过程中报错或卡住？A: 99% 是网络问题。请检查是否按照本文第三步配置了 npmmirror 镜像。