关于 nvm 使用指南

1. 什么是 nvm？

• nvm 是一个命令行工具，用于在系统中安装和管理多个 Node.js 版本。
• 支持 macOS/Linux（原版 nvm），Windows 用户需使用 nvm-windows 或替代工具（如 fnm）。

---

2. 安装 nvm

macOS/Linux

# 使用官方脚本安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 或使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装后重启终端或执行：

命令/代码	作用	适用场景
source ~/.bashrc	重新加载 Bash 配置	Bash 用户，配置更新后立即生效
source ~/.zshrc	重新加载 Zsh 配置	Zsh 用户，配置更新后立即生效
export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"	手动设置 nvm 环境并初始化	临时激活 nvm 或修复配置缺失

Windows

• 下载安装包：nvm-windows 官方仓库
• 安装后以管理员身份运行命令提示符或 PowerShell。

---

3. 常用命令

命令	说明
nvm install <version>	安装指定 Node.js 版本（如 18.17.1）
nvm install --lts	安装最新的 LTS 版本
nvm use <version>	切换当前终端使用的 Node 版本
nvm alias default <version>	设置默认 Node 版本
nvm ls	查看已安装的所有版本
nvm ls-remote	查看远程可安装的版本列表
nvm uninstall <version>	卸载指定版本
nvm current	显示当前使用的 Node 版本
nvm run <version> <script>	使用指定版本运行脚本

---

4. 使用示例

安装最新 LTS 版本

nvm install --lts
nvm use --lts

安装指定版本并设为默认

nvm install 20.5.0
nvm alias default 20.5.0

临时切换版本运行项目

nvm use 18.17.1
npm start

---

5. 项目级版本管理

使用 .nvmrc 文件

1. 在项目根目录创建 .nvmrc 文件：

   echo "20.5.0" > .nvmrc

2. 进入项目目录时自动切换版本（需配置 Shell 插件或手动执行）：

   nvm use

---

6. 常见问题

安装后命令未找到

• 确保 nvm 环境变量已加载，检查 Shell 配置文件（如 ~/.bashrc, ~/.zshrc）是否包含以下内容：

  export NVM_DIR="$HOME/.nvm"
  [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Windows 权限问题

• 以管理员身份运行终端，或修改安装路径为非系统目录（如 C:\nvm）。

镜像加速（国内用户）

• 设置 Node.js 二进制镜像（如淘宝源）：

  export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

---

7. 替代工具

• fnm （Fast Node Manager）：跨平台，速度更快。

  安装命令：

  curl -fsSL https://fnm.vercel.app/install | bash

---

8. 最佳实践

1. 统一团队版本 ：在项目中添加 .nvmrc，确保成员使用相同 Node 版本。
2. 定期更新：使用 LTS 版本以获得长期支持。
3. 清理旧版本：定期卸载不再使用的版本，节省磁盘空间。