王杰岸在 Ubuntu 24.04 上安装 Node.js 这件事，看起来就是个“下载、解压、配 PATH”的简单活，但实际操作里版本选型、安装方式、权限坑、镜像源这些问题，十个人能遇到八种不同报错。我整理了一份基于 2026 年 2 月初实际操作经验的完整流程，覆盖目前主流的四种安装方式，并补齐了环境配置和常见问题排查，希望帮你一次装好、装对、用得稳。
本文适合刚接触 Linux、第一次在 Ubuntu 24.04 上搭建 Node.js 环境的初学者，也适合需要多版本切换、做嵌入式开发（比如 ESP-IDF）或 ROS2 开发的同学参考。内容不光是命令的堆叠，我会把每一步背后的原理、我踩过的坑和选择理由都讲清楚。
1. 安装方式与版本选型思路
1.1 为什么不用 apt 直接装
很多新手拿到 Ubuntu 24.04 的第一反应是 sudo apt install nodejs npm，这条命令确实能装上，但它默认提供的是 Node.js 18.x（取决于你系统当前源的状态），放到 2026 年来看已经偏旧了。如果你只是简单跑个脚本可能无所谓，但遇到需要较新语法特性的前端工程、AI 相关工具链或者官方长期支持版本时，18.x 会时不时冒出版本不兼容的问题。
另外 apt 装的 Node.js 和 npm 经常不是一个版本节奏，npm 可能比 Node 旧不少，npm install 某些较新的包时也会出现引擎不兼容的警告。所以我的建议是：除非你明确知道自己只需要系统仓库里那个老版本，否则不要用 apt 作为首选安装途径。
1.2 主流安装方式对比
我把目前 Ubuntu 24.04 上常见的几种安装方式做过一轮对比，各有适用场景，简单整理如下：
| 安装方式 | 版本控制能力 | 安装速度 | 适合场景 |
|---|---|---|---|
| nvm（Node Version Manager） | 强，多版本随意切换 | 中（需要下载） | 日常开发、多项目并行、工具链兼容 |
| NodeSource 官方源 | 中，装完系统级，可指定大版本 | 快 | 服务器部署、不想折腾环境变量的场景 |
| 官方二进制包手动部署 | 弱，手动管版本 | 快 | 一次性固定版本、离线安装 |
| apt 系统仓库 | 弱，版本旧 | 最快 | 对版本无要求、只是临时用一下 |
我个人在开发机上首选 nvm，在服务器或临时环境里用 NodeSource 官方源，二进制包适合固定版本做离线部署。以下三种最值得掌握的方法，我会逐步拆开讲。
1.3 版本选择建议：LTS 优先
Node.js 发布节奏比较规律，每年 4 月和 10 月会各出一个新的大版本，其中偶数版本进入 LTS（长期支持期），生产环境推荐用 LTS 版本。
以 2026 年 2 月这个时间节点来看，我建议优先选择 Node.js 22 LTS 或更高的 LTS 版本。一些嵌入式工具链如果用 v18 会提示要求至少 v16 以上，Node.js 22 使用下来兼容性最稳。如果你要装 ESP-IDF，它对 Node 版本没有过于苛刻的要求，v18 往上基本都能跑，但为了后续其他项目考虑，还是建议一步到位用 v22。
注意：不要盲目追求最新 Current 版本，这类版本迭代快、可能有行为变更，碰到某些老依赖包时会遇到编译失败或原生模块不支持的情况，开发中非常折腾。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 三种主流安装方式完整实操
2.1 方式一：nvm 安装（最推荐）
nvm 是管理 Node.js 版本最方便的工具，好处是安装完全隔离在用户目录下，不需要 sudo，想切版本随时切。下面是完整流程。
第一步，先确认系统里有没有装 curl 或 wget：
bash复制sudo apt update
sudo apt install -y curl
第二步，用官方脚本安装 nvm：
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
这里有两个细节需要注意：一是版本号 v0.40.1 是写这篇文章时我建议的版本，你实际操作前最好去 nvm 的 GitHub Releases 页面看下最新 tag，替换成新版本号即可；二是如果你的网络环境访问 GitHub raw 不稳定，可以考虑用下面的镜像方式：
bash复制curl -o- https://gite