Skip to content

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 (含自动配置)

nvm-windows发布页截图

步骤3:运行安装程序

  1. 右键选择以管理员身份运行安装程序
  2. 按提示完成安装(接受默认路径最佳)
  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

注意事项

  1. 路径规范:安装路径禁止包含中文和特殊字符
  2. 权限问题:安装和切换时使用管理员权限终端
  3. 版本切换后:若node -v未生效,重启终端即可
  4. 代理配置:公司网络受限时可添加环境变量:
    NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

建议定期更新nvm-windows:

powershell
nvm update

💡 替代方案
若需多环境开发,可考虑Windows子系统WSL安装原生nvm,文档参见nvm官方仓库