SD07_NVM的安装及相关操作

以下是在 Windows 系统 上使用 NVM（Node Version Manager） 管理多个 Node.js 版本的详细步骤，从零开始操作：

---

一、准备工作

1. 卸载旧版 Node.js

   • 打开 控制面板 → 程序和功能，找到已安装的 Node.js 和 npm，彻底卸载。
   • 删除残留环境变量（如 PATH 中的 Node.js 路径）。
   • 清除缓存目录（如 C:\Users<用户名>\AppData\Roaming\npm）。

2. 以管理员身份运行命令行工具

   • 所有后续操作需以管理员权限运行 CMD 或 PowerShell，避免权限问题。

---

二、安装 NVM（Node Version Manager）

1. 下载 NVM 安装包

   • 访问 NVM for Windows 官方 GitHub 发布页面。
   • 下载最新版本的安装程序（如 nvm-setup.zip）。

2. 运行安装程序

   • 双击下载的安装包（如 nvm-setup.exe），进入安装向导。
   • 安装路径选择：
     • 建议使用默认路径（如 C:\Users<用户名>\AppData\Roaming\nvm），避免路径含空格。
     • 若自定义路径，请确保路径无空格（如 D:\nvm）。
   • Node.js 安装路径：
     • 默认路径为 C:\Program Files\nodejs，无需手动创建，NVM 会自动处理软链接。

3. 验证安装

   • 安装完成后，在管理员 CMD 或 PowerShell 中输入以下命令：

     nvm version
     

   • 如果显示 NVM 的版本号（如 1.1.12），说明安装成功。

---

三、配置镜像加速（国内用户推荐）

1. 修改 NVM 配置文件
   • 找到 NVM 安装目录下的 settings.txt 文件（默认路径：C:\Users<用户名>\AppData\Roaming\nvm\settings.txt）。
   • 在文件末尾添加以下内容（使用国内镜像加速下载）：

     node_mirror: https://npmmirror.com/mirrors/node/
     npm_mirror: https://npmmirror.com/mirrors/npm/
     

---

四、安装和管理 Node.js 版本

1. 查看可用版本

   • 输入以下命令，查看所有可安装的 Node.js 版本：

     nvm list available
     

   • 输出示例：

     16.15.0
     18.20.5
     20.14.0
     

2. 安装指定版本

   • 选择需要安装的版本（如 18.20.5），输入以下命令：

     nvm install 18.20.5
     

   • 等待下载和安装完成（受镜像加速影响，速度较快）。

3. 切换 Node.js 版本

   • 安装完成后，输入以下命令切换版本：

     nvm use 18.20.5
     

   • 验证当前版本：

     node -v   # 应输出 v18.20.5
     npm -v    # 显示对应的 npm 版本
     

4. 安装多个版本

   • 重复上述步骤，安装其他版本（如 16.15.0 和 20.14.0）：

     nvm install 16.15.0
     nvm install 20.14.0
     

5. 查看已安装版本

   • 输入以下命令，列出所有已安装的 Node.js 版本：

     nvm list
     

6. 卸载指定版本

   • 输入以下命令卸载某个版本（如 16.15.0）：

     nvm uninstall 16.15.0
     

---

五、项目级版本管理

1. 创建 .nvmrc 文件
   • 在项目根目录创建 .nvmrc 文件，指定项目所需的 Node.js 版本：

     echo "20.14.0" > .nvmrc
     

   • 运行以下命令自动切换版本：

     nvm use
     

---

六、常见问题及解决方案

1. 权限不足

   • 以管理员身份运行 CMD 或 PowerShell。

2. 路径含空格导致报错

   • 确保 NVM 安装路径和 Node.js 安装路径无空格（如 D:\nvm）。

3. 镜像失效

   • 更新 settings.txt 中的镜像地址，尝试以下镜像：

     node_mirror: https://mirrors.aliyun.com/nodejs-release/
     npm_mirror: https://mirrors.aliyun.com/npm/
     

4. 切换版本失败

   • 检查路径是否正确，重启终端后重试。

5. NVM 命令无效

   • 检查环境变量 NVM_HOME 和 NVM_SYMLINK 是否正确配置，并确保路径已加入 PATH。

---

七、替代方案（不推荐）

如果不使用 NVM，可手动管理 Node.js：

1. 从 Node.js 官网 下载 ZIP 包。
2. 解压至独立目录（如 D:\nodejs\v18.20.5）。
3. 手动修改 PATH 环境变量切换版本（操作繁琐，易出错）。

---

八、总结

通过 NVM，你可以轻松在 Windows 上管理多个 Node.js 版本，避免版本冲突问题。核心命令包括：

• nvm install <version>：安装指定版本。
• nvm use <version>：切换版本。
• nvm list：查看已安装版本。
• nvm uninstall <version>：卸载版本。

如果需要进一步优化开发环境，可结合 Docker 或 Volta 工具实现更灵活的版本管理。