NVM 安装与 WebStorm 配置全指南
# Windows 下 Node 版本管理神器：NVM 安装与 WebStorm 配置全指南
在前端开发中，我们经常面临一个头疼的问题：老项目依赖 Node v14，新项目需要 Node v18，甚至还想尝鲜 Node v20。手动反复卸载安装 Node.js 极其低效且容易出错。
本文将手把手教你在 Windows 系统下使用 NVM (Node Version Manager) 优雅地管理多个 Node 版本，并解决 WebStorm 中的配置问题。
# ⚠️ 第一步：彻底清理旧环境（至关重要）
在安装 NVM 之前，必须彻底卸载电脑上现有的 Node.js 版本，否则会导致路径冲突，使得版本切换失效。
- 打开 设置 -> 应用 -> 安装的应用，找到
Node.js并卸载。 - 检查并删除以下残留文件夹（如果存在）：
C:\Program Files\nodejsC:\Program Files (x86)\nodejsC:\Users\<你的用户名>\AppData\Roaming\npmC:\Users\<你的用户名>\AppData\Roaming\npm-cache
# 🚀 第二步：下载与安装 NVM
- 下载安装包 前往 GitHub 发布页下载最新版：nvm-windows releases (opens new window)
推荐下载
nvm-setup.exe或nvm-setup.zip。
- 安装配置
- 双击运行安装程序。
- 安装路径建议：建议修改默认路径，避免路径中包含空格（如
Program Files），推荐安装在根目录下，例如： - NVM 目录：
D:\nvm - Node Symlink 目录：
D:\nodejs
- 验证安装 打开 CMD 或 PowerShell，输入：
nvm version
2
如果出现版本号（如 1.1.12），说明安装成功。
# ⚡ 第三步：配置国内镜像（加速下载）
默认源在国外，下载速度极慢。建议安装后立即配置国内镜像源。
在命令行中依次执行：
# 设置 Node 镜像
nvm node_mirror https://npmmirror.com/mirrors/node/
# 设置 npm 镜像
nvm npm_mirror https://npmmirror.com/mirrors/npm/
2
3
4
5
6
# 🛠 第四步：常用命令速查表
以下是日常开发中最常用的指令流程：
# 1. 查看可安装版本
nvm list available
2
# 2. 安装特定版本
nvm install 18.16.0
# 或者安装最新的长期支持版
nvm install lts
2
3
4
# 3. 查看已安装版本
nvm list
2
# 4. 切换使用版本（关键）
注意：执行此命令通常需要管理员权限（右键 CMD/PowerShell -> 以管理员身份运行）。
nvm use 18.16.0
2
# 5. 验证环境
node -v
npm -v
2
3
# 💻 第五步：WebStorm 配置与清理
很多开发者在 WebStorm 中会遇到 Node 版本混乱的问题，这里统一说明如何配置及清理。
# 1. 正确配置 WebStorm 的 Node 解释器
为了让 WebStorm 跟随你系统 nvm use 的版本自动切换：
- 打开设置：
File->Settings->Languages & Frameworks->Node.js。 - 在 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
2
3
# ❓ 常见问题 FAQ
Q: 执行 nvm use 报错 "Access is denied"？ A: 权限不足。请务必右键点击终端图标，选择**“以管理员身份运行”**。
Q: 切换版本后，刚才安装的 yarn 或 vue-cli 不见了？ A: 这是正常的。NVM 中每个 Node 版本的全局包（Global Packages）是相互隔离的。切换到新版本后，需要重新安装该版本所需的全局包。
Q: 下载 Node 过程中报错或卡住？ A: 99% 是网络问题。请检查是否按照本文第三步配置了 npmmirror 镜像。
- 02
- 使用 acme.sh 自动化SSL证书管理03-25
- 03
- COSCLI 的使用记录03-25