前言

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，广泛用于构建后端服务和前端工具链。本文将介绍如何在 Ubuntu 系统上使用 nvm（Node Version Manager）安装和管理 Node.js。

为什么选择 nvm？

虽然可以直接使用 apt 安装 Node.js：

1
sudo apt install nodejs

但 apt 仓库中的版本通常较旧，而 nvm 具有以下优势：

  • 版本灵活：可以安装任意版本，包括最新的 LTS 版本
  • 多版本管理：轻松切换不同 Node.js 版本
  • 用户级别安装：无需 sudo 权限，避免权限问题
  • 环境隔离：不同项目可以使用不同 Node.js 版本

使用 nvm 安装 Node.js

1. 安装 nvm

打开终端，执行以下命令下载并安装 nvm：

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

这个脚本会：

  • 克隆 nvm 仓库到 ~/.nvm
  • 尝试将配置添加到 shell 配置文件（~/.bashrc、~/.profile 或 ~/.zshrc）

2. 加载 nvm

安装完成后，需要加载 nvm 到当前 shell 会话：

1
2
3
4
5
# 方式一：重新加载配置文件
source ~/.bashrc

# 方式二：直接执行 nvm 脚本（无需重启 shell）
\. "$HOME/.nvm/nvm.sh"

验证 nvm 是否安装成功：

1
2
nvm --version
# 应输出 0.40.3 或类似版本号

3. 安装 Node.js

使用 nvm 安装 Node.js 24 版本：

1
2
# 安装最新版 Node.js 24
nvm install 24

这个过程会自动：

  • 下载指定版本的 Node.js
  • 编译安装（如果需要）
  • 将该版本设为默认版本

4. 验证安装

检查 Node.js 和 npm 版本：

1
2
3
4
5
6
7
# 检查 Node.js 版本
node -v
# 应输出 "v24.13.1"

# 检查 npm 版本
npm -v  
# 应输出 "11.8.0"

nvm 常用命令

版本管理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 安装指定版本
nvm install 18.17.0    # 安装特定版本
nvm install --lts      # 安装最新的 LTS 版本

# 切换版本
nvm use 18.17.0        # 临时切换
nvm alias default 18   # 设置默认版本

# 列出已安装版本
nvm ls

# 列出可安装版本
nvm ls-remote

# 卸载版本
nvm uninstall 14.18.0

项目特定版本

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

1
echo "18.17.0" > .nvmrc

然后进入项目目录时使用：

1
nvm use

常见问题解决

1. nvm 命令找不到

如果重启终端后 nvm 命令找不到，手动加载：

1
source ~/.bashrc

或者检查 shell 配置文件是否正确添加了 nvm 配置。

2. 安装慢或失败

可以配置镜像加速：

1
2
3
4
5
# 设置镜像地址
export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/

# 或者写入配置
echo 'export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/' >> ~/.bashrc

3. 权限问题

使用 nvm 安装的 Node.js 在用户目录下，无需 sudo。如果遇到权限错误，检查：

  • 是否尝试在系统目录安装全局包
  • 是否正确设置了 npm 全局安装路径

4. 重新加载配置

如果在安装后无法使用 node 命令，尝试：

1
2
3
4
5
# 重新加载 shell 配置
source ~/.bashrc

# 或重新登录终端
exec $SHELL -l

卸载说明

卸载 nvm

1
2
3
4
5
6
7
# 1. 删除 nvm 目录
rm -rf ~/.nvm

# 2. 从 shell 配置文件（~/.bashrc、~/.zshrc 等）中删除相关配置
# 删除或注释掉类似下面的行：
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

卸载通过 nvm 安装的 Node.js

1
2
3
4
5
# 先卸载指定版本
nvm uninstall 24

# 或删除整个 nvm 目录（会删除所有版本）
rm -rf ~/.nvm

总结

使用 nvm 安装 Node.js 是最灵活、推荐的方式，特别适合：

  • 需要在多个 Node.js 版本间切换的开发者
  • 想使用最新版本的开发者
  • 避免 sudo 权限问题的场景

安装流程简单总结：

  1. 安装 nvm：一行命令完成
  2. 加载配置：source ~/.bashrc
  3. 安装 Node.js：nvm install 24
  4. 验证：node -v

说些什么吧！

giscus