关于 nvm 使用指南

哈撒Ki
368 阅读1分钟

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

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. 清理旧版本：定期卸载不再使用的版本，节省磁盘空间。
avatar
文章
阅读
粉丝