Ubuntu 安装 NVM (Node Version Manager)

2025-05-31 06:01:02 5 阅读

NVM (Node Version Manager)

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

先决条件

安装 NVM 之前，通常需要确保系统已安装 curl (或 wget) 和 git。Ubuntu 系统可以使用以下命令安装：

sudo apt update
sudo apt install curl git -y

安装 NVM

您可以选择使用官方源或国内镜像源进行安装。

方法一：官方 GitHub 源 (推荐)

这是标准的安装方法，直接从 NVM 的官方 GitHub 仓库下载并执行安装脚本。

# 注意：v0.40.1 是脚本中的示例版本号。
# 建议访问 NVM GitHub 仓库 ([https://github.com/nvm-sh/nvm](https://github.com/nvm-sh/nvm)) 查看最新的稳定版本号，并替换下面的版本号。
curl -o- [https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh](https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh) | bash

方法二：国内 Gitee 镜像源 (备选方案)

如果您在访问 GitHub 时遇到网络问题（例如 curl 命令报错“连接被拒绝”或下载速度过慢），可以尝试使用国内 Gitee 上的镜像。

# 从 Gitee（国内的Git托管平台）下载并执行 NVM-CN 提供的安装脚本
bash -c "$(curl -fsSL [https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh](https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh))"

请注意：使用第三方镜像可能存在更新不及时或潜在的安全风险，请根据自己的判断选择使用。

配置环境变量

NVM 安装脚本通常会自动尝试将必要的配置添加到您的 shell 配置文件中（如 ~/.bashrc, ~/.zshrc, ~/.profile 等）。为了让更改在当前的终端会话中立即生效，您需要执行以下命令来重新加载配置文件：

# 如果您使用的是 bash (Ubuntu 默认的 shell)
source ~/.bashrc

# 如果您使用的是 zsh，则执行:
# source ~/.zshrc

或者，您可以简单地关闭当前终端窗口并重新打开一个新的终端窗口。

测试安装

为了验证 NVM 是否已成功安装并可以正常工作，请在终端中运行以下命令：

nvm --version

如果安装成功，这个命令会输出 NVM 的版本号，例如 0.40.1。您也可以使用 command -v nvm 来检查 nvm 命令是否在您的 PATH 中，它应该输出 nvm。

基本使用示例

以下是一些常用的 NVM 命令：

# 安装最新的 Node.js LTS (长期支持) 版本
nvm install --lts

# 安装指定版本的 Node.js (例如 v18.17.0)
nvm install 18.17.0

# 查看所有本地已安装的 Node.js 版本
nvm ls

# 查看所有可供安装的远程 Node.js 版本 (列表可能很长)
nvm ls-remote

# 在当前终端会话中切换使用指定版本的 Node.js
nvm use 18.17.0

# 设置默认使用的 Node.js 版本 (新打开的终端将默认使用此版本)
nvm alias default 18.17.0

卸载 NVM

如果您需要卸载 NVM，可以使用以下方法：

方法一：使用 Gitee 镜像提供的卸载脚本

如果您是通过 Gitee 镜像安装的，并且该镜像提供了卸载脚本，您可以使用它：

bash -c "$(curl -fsSL [https://gitee.com/RubyMetric/nvm-cn/raw/main/uninstall.sh](https://gitee.com/RubyMetric/nvm-cn/raw/main/uninstall.sh))"

注意：请确认该卸载脚本的来源和安全性。

方法二：手动卸载 (通用方法)

删除 NVM 目录：NVM 及其安装的 Node 版本通常位于 ~/.nvm 目录下。
```
rm -rf ~/.nvm
```
编辑 Shell 配置文件：打开您的 shell 配置文件（如 ~/.bashrc, ~/.zshrc 等），找到并删除与 NVM 相关的行。这些行通常包含 NVM_DIR 或 nvm.sh，例如：
```
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
```
将这些行从文件中删除。
*应用更改*：重新加载配置文件或重启终端。
```
source ~/.bashrc  # 或相应的配置文件
```