Ubuntu 安装 Node.js 22.x（通过 NodeSource 官方源）

好的，既然 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - 这条命令已经成功执行，说明 NodeSource 仓库已正确添加。下面是完整的 Ubuntu 安装 Node.js 22.x（LTS） 操作文档，你可以直接保存为 install-nodejs.md 或复制使用。

Ubuntu 安装 Node.js 22.x（通过 NodeSource 官方源）

适用环境：Ubuntu 20.04 / 22.04 / 24.04（及其他 Debian 系发行版）

安装方式：使用 NodeSource 提供的二进制仓库，可获得较新且稳定的 Node.js 版本。

1. 前提条件

具有 sudo 权限的用户
系统已安装 curl（如未安装，执行 sudo apt install curl -y）
网络连接正常（若访问国外源慢，可参考下方"国内镜像加速"章节）

2. 添加 NodeSource 仓库

执行以下命令，将 Node.js 22.x 的仓库添加到系统中：

bash 复制代码

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

这条命令做了什么？

自动检测系统发行版和版本
添加 NodeSource 的 APT 源（/etc/apt/sources.list.d/nodesource.list）
导入对应的 GPG 公钥
自动执行 sudo apt update（更新包列表）

3. 安装 Node.js 和 npm

bash 复制代码

sudo apt install -y nodejs

说明：npm 会随 Node.js 一同安装，无需单独安装。

4. 验证安装

检查版本号，确认安装成功：

bash 复制代码

node -v   # 应输出 v22.x.x
npm -v    # 应输出对应的 npm 版本（如 10.x.x）

5. （可选）安装开发工具（构建原生模块）

如果需要编译原生 Node.js 附加组件，建议安装开发工具：

bash 复制代码

sudo apt install -y build-essential

6. 常见问题与解决

6.1 下载速度慢或失败

如果 curl 步骤超时或很慢，可以使用国内镜像（如中科大源）替换：

bash 复制代码

curl -fsSL https://mirrors.ustc.edu.cn/nodesource/deb/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

6.2 与旧版本冲突

如果之前通过 Ubuntu 官方源安装了旧版 Node.js，建议先移除：

bash 复制代码

sudo apt remove --purge nodejs npm -y
sudo apt autoremove -y

然后再执行上述安装步骤。

6.3 需要切换版本（多版本管理）

如果后续需要管理多个 Node.js 版本，推荐配合 nvm 使用（但 nvm 与系统全局安装的 Node 可能存在冲突，建议二选一）。

若只需单个版本，NodeSource 方案是最简单的。

7. 下一步：安装全局工具（如 reasonix）

以 reasonix 为例，升级 Node 后重新安装：

bash 复制代码

npm uninstall -g reasonix   # 如有旧版本
npm install -g reasonix
reasonix setup

8. 参考链接

保存此文档，以后重装系统或部署新服务器时，即可按步骤快速完成 Node.js 安装。如有其他问题，随时补充。 😊