Windows系统安装nvm指南
问题描述
开发者尝试在Windows系统安装Node版本管理工具nvm时,使用了Linux/macOS平台的安装命令:
bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
却遇到路径错误提示:
The system cannot find the path specified.
curl: (23) Failure writing output to destination
此问题根源在于官方nvm不支持Windows系统。需要安装专为Windows设计的替代方案——nvm-windows
。
解决方案
步骤1:彻底卸载现有Node.js
进入Windows控制面板→"程序和功能"→完整卸载以下组件:
- Node.js
- npm
- 所有残留的node_modules目录
⚠️ 必须操作
不彻底卸载将导致nvm与直接安装的Node.js产生冲突
步骤2:下载nvm-windows安装包
直接访问项目GitHub发布页下载最新安装包:
- 选择以
.exe
结尾的安装文件 - 推荐下载
nvm-setup.exe
(含自动配置)
步骤3:运行安装程序
- 右键选择以管理员身份运行安装程序
- 按提示完成安装(接受默认路径最佳)
- 安装后重新启动终端窗口
验证安装
打开新的命令提示符(CMD)或PowerShell:
powershell
nvm version
成功安装将显示版本号(如1.1.12
),而非"命令不存在"错误。
常用命令实战
powershell
# 查看可用Node版本列表
nvm list available
# 安装指定Node版本
nvm install 18.19.0
# 切换当前使用版本
nvm use 20.10.0
# 查看已安装版本
nvm list
# 设置默认版本
nvm alias default 18.19.0
注意事项
- 路径规范:安装路径禁止包含中文和特殊字符
- 权限问题:安装和切换时使用管理员权限终端
- 版本切换后:若
node -v
未生效,重启终端即可 - 代理配置:公司网络受限时可添加环境变量:
NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
建议定期更新nvm-windows:
powershell
nvm update
💡 替代方案
若需多环境开发,可考虑Windows子系统WSL安装原生nvm,文档参见nvm官方仓库