技术手册
文章 标签 系列 关于
技术手册

NVM (Node Version Manager) 的安装

HenryZ    更新于   
 收录于  系列 Node.js手册

NVM (Node Version Manager) 是一个用于管理多个 Node.js 版本的工具，允许您在同一台机器上安装和切换不同版本的 Node.js。

可访问官方仓库查看最新版本： https://github.com/nvm-sh/nvm

本文以v0.40.3版本为例：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

安装完成后，需要重新启动终端或运行以下命令使其生效：

source ~/.bashrc
# 或者
source ~/.zshrc

brew install nvm

安装完成后，需要在 shell 配置文件中添加以下内容：

编辑 ~/.zshrc 文件：

export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"  # This loads nvm
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"  # This loads nvm bash_completion

编辑 ~/.bash_profile 或 ~/.bashrc 文件：

export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"

如果自动安装脚本失败，可以手动安装：

  1. 克隆仓库到本地：
git clone https://github.com/nvm-sh/nvm.git ~/.nvm
  1. 检出最新版本：
cd ~/.nvm
git checkout v0.40.3
  1. 激活 nvm：
. ~/.nvm/nvm.sh
  1. 添加到 shell 配置文件中（同上述方法二）

重新启动终端后，运行以下命令验证安装是否成功：

nvm --version
# 应该显示类似：0.40.3

如果显示 command not found，请确保：

  1. 配置文件已正确添加
  2. 重新启动了终端
  3. 配置文件路径正确

对于 Windows 用户，标准的 nvm 不支持 Windows。建议使用：

  • 项目地址：https://github.com/coreybutler/nvm-windows
  • 下载链接：https://github.com/coreybutler/nvm-windows/releases

在 WSL 中可以使用标准版 nvm，按照上述 Linux/macOS 方法安装。

确保 shell 配置文件路径正确：

  • macOS (zsh): ~/.zshrc
  • macOS (bash): ~/.bash_profile
  • Linux (bash): ~/.bashrc

如果下载缓慢或失败，可以：

  1. 使用镜像源（如 npm 更换国内镜像）
  2. 手动下载安装脚本后执行
  3. 通过代理安装
  • 请不要使用 sudo 安装 nvm
  • 确保用户对 $HOME/.nvm 目录有读写权限

如果在 macOS 上遇到问题：

# 确保使用正确的 homebrew 路径
# Intel Mac
[ -s "/usr/local/opt/nvm/nvm.sh" ] && \. "/usr/local/opt/nvm/nvm.sh"

# Apple Silicon Mac
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"

安装完成后，可以开始使用 nvm 管理 Node.js 版本：

 Node.js, Nvm
返回 | 主页