一、NVM在Windows环境下的使用

1. 安装前准备

  • 卸载现有Node.js:确保系统中没有安装任何Node.js版本,避免与nvm冲突
    • 通过控制面板卸载Node.js
    • 删除残留文件:
      • 安装目录(如C:\Program Files\nodejs)
      • 用户目录下的.npmrc文件(C:\Users\用户名)
      • 系统环境变量中的NODE_PATH

2. 下载与安装nvm-windows

  1. 访问GitHub地址:https://github.com/coreybutler/nvm-windows/releases
  2. 下载最新版nvm-setup.exe
  3. 双击运行安装程序:
    • 选择nvm安装路径(建议:D:\nvm)
    • 选择Node符号链接路径(建议:D:\nvm\nodejs)
    • 点击"Install"完成安装

3. 验证安装

管理员身份打开CMD/PowerShell,执行:

nvm version

如果显示版本号(如1.1.11),则安装成功

4. 配置淘宝镜像(加速下载)

  1. 找到nvm安装目录下的settings.txt(如D:\nvm\settings.txt)
  2. 添加以下内容:
    root: D:\nvm
    path: D:\nvm\nodejs
    node_mirror: https://npmmirror.com/mirrors/node/
    npm_mirror: https://npmmirror.com/mirrors/npm/
    
  3. 配置npm全局镜像:
    npm cache clean --force
    npm config set registry https://registry.npmmirror.com
    npm config get registry  # 验证配置
    

5. 常用NVM命令

功能 命令 说明
查看可安装版本 nvm list available 查看所有可用Node.js版本
安装指定版本 nvm install 16.20.2 安装指定版本(LTS)
切换版本 nvm use 16.20.2 切换到指定版本
查看已安装版本 nvm list 显示已安装版本(*号为当前版本)
卸载版本 nvm uninstall 16.20.2 卸载指定版本
设置默认版本 nvm alias default 16.20.2 设置默认版本

⚠️ 注意:切换Node版本时,必须以管理员身份运行终端,否则会提示"exit status 1"

二、修改npm全局安装路径

1. 查看当前全局安装路径

npm config get prefix

2. 修改全局安装路径

npm config set prefix "D:\npm_global"

建议路径:D:\npm_global(无中文、无空格的路径)

3. 添加系统环境变量

  1. 右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
  2. 在"系统变量"中,找到"Path"变量 → 点击"编辑" → "新建"
  3. 添加新路径:D:\npm_global
  4. 点击"确定"保存所有更改

📌 重要提示:修改环境变量后,必须重新打开CMD或PowerShell窗口,使系统变量更新生效

4. 验证修改

npm config get prefix

应显示你设置的路径

三、使用nvm时的路径管理(推荐方式)

使用nvm是最推荐的路径管理方式,因为:

  1. nvm会自动管理Node.js和npm的安装路径
  2. 无需手动修改环境变量
  3. 不同Node版本的npm路径自动隔离

当你使用nvm安装Node.js后,npm的安装路径会自动设置在nvm指定的路径下(如D:\nvm\nodejs),无需再手动配置。

四、常见问题解决

1. nvm命令无效

  • 确保以管理员身份运行CMD/PowerShell
  • 检查环境变量是否正确设置
  • 重启电脑

2. 安装失败

  • 确保安装路径无中文和空格
  • 关闭杀毒软件再试

3. npm命令无法识别

  • 确保已将npm路径添加到系统Path环境变量
  • 重新打开命令行窗口

总结

  • 推荐使用nvm管理Node.js版本,它能自动处理路径问题,避免手动配置的麻烦
  • 如需修改npm全局路径,使用npm config set prefix命令
  • 修改路径后必须重新打开命令行窗口才能生效
  • 建议使用无中文、无空格的路径(如D:\npm_global)

通过以上步骤,你可以轻松在Windows环境下管理多个Node.js版本,并灵活配置npm的安装路径,避免因路径问题导致的开发困扰。