眠子子子1. 环境准备：装之前先看清这几件事
Ubuntu 24.04 是 Canonical 在 2024 年发布的 LTS 长期支持版本，内核 6.8，默认源里的 Node.js 版本比较保守。如果直接 apt install nodejs，装出来大概率是 18.x 甚至更老的版本，这在 2026 年做前端开发或者跑一些新框架时会出现兼容性问题。所以安装 Node.js 之前，先想清楚三件事：你要装哪个版本、用什么方式管理版本、后续升级和卸载是否方便。
先说结论：个人开发机推荐使用 nvm（Node Version Manager）方式安装，理由是它可以随时切换 Node 版本，适配不同项目的 .nvmrc 文件要求，而且在测试新版本时不用污染系统环境。服务器或者生产环境则推荐使用 NodeSource 官方源或者二进制包直接安装，少一层中间管理工具，环境更干净，也更容易被运维脚本覆盖。如果你只是临时跑个脚本、做个课程作业，那么直接 apt install nodejs npm 也能应付，只要你能接受版本偏旧这个事实。
在开始之前，建议先检查系统是否已有 Node.js 残留。执行 node -v 和 npm -v，如果提示 command not found，说明干净；如果有输出，检查一下版本和安装来源。已有的残留版本会影响新装环境的 PATH 优先级，后续操作时容易混淆“为什么我装完了还是旧版本”。如果之前是用 apt 装的，先执行 sudo apt remove nodejs npm -y 清理干净，建议连 /usr/local/lib/node_modules、~/.npm 这些目录也查一遍，避免旧包干扰。
提示：如果是全新安装的 Ubuntu 24.04，建议先执行
sudo apt update && sudo apt upgrade -y把系统基础库更新到最新，尤其是 build-essential、python3、make 这类编译工具链，后面源码编译 Node.js 时直接用得上。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装方式对比：apt、nvm、源码到底选哪个
在 Ubuntu 24.04 上安装 Node.js，网上的教程能搜出一大堆，但归纳起来无非四条路：系统源安装、NodeSource 源安装、nvm 安装、源码编译安装。每条路的适用场景和坑点都不一样，我逐个拆开讲。
2.1 apt 直接安装：最省事但版本老
Ubuntu 24.04 的官方软件源中，Node.js 版本停留在 18.x 系列（具体小版本随仓库更新而变化）。执行 sudo apt install nodejs npm，装完直接可用，npm 也会一并装上。但这种方式的限制很明显：第一，你无法选择版本，源里是什么就是什么；第二，18.x 版本在 2026 年已经进入维护末期，如果用 Vitest 3、Webpack 5.9x 以上或者部分依赖 Node 20 API 的库，直接会报错；第三，apt upgrade 时如果源更新了 Node 版本，可能出现大版本跳变，导致项目依赖出问题。
如果你确定要装老版本，或者只是给某些老旧项目维护环境，apt 也够用。注意装完后 npm 可能需要单独执行 sudo apt install npm 才能获得，因为 Ubuntu 把 nodejs 和 npm 拆成了两个包。另外，apt 装的 Node.js 目录结构遵循 Debian 规范，可执行文件在 /usr/bin/node，全局包在 /usr/lib/node_modules 下，和 NodeSource 或 nvm 的安装路径不同。这种差异会影响后续某些工具链查找 Node 模块的逻辑，遇到奇奇怪怪的问题时先意识到这一点。
2.2 NodeSource 源安装：服务器环境的首选
NodeSource 是一个第三方维护的 Node.js apt 仓库，提供从 18.x 到当前最新版本的完整支持。它安装的 Node.js 是官方编译好的二进制，版本精准可控，更新策略独立于系统的 apt 源。我一般会在需要固定 Node 版本的服务器上用这种方案，配合 apt-mark hold nodejs 锁定版本，防止意外升级。
安装流程很简单：
bash复制curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
把 setup_20.x 换成你需要的版本号即可（目前也可用 22.x）。这段命令会动态添加 NodeSource 仓库到 /etc/apt/sources.list.d/，同时导入 GPG 密钥。需要注意，NodeSource 在 2025 年调整过仓库地址和密钥轮换策略，旧教程里的 nodesource.com/dist 老路径已失效，务必按官网最新命令操作。执行完后 node -v 应该打印出对应的版本号，npm 也会一并装好。
NodeSource 方式有一个问题：如果你在某个特定网络环境下，curl 拉取脚本可能超时或被拦截，这时候可以手动添加仓库而不是执行脚本。具体做法是：
bash复制curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg
VERSION=node_20.x
echo "deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/$VERSION noble main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt update
sudo apt install -y nodejs
这里的关键是 noble，它是 Ubuntu 24.04 的发行版代号，如果你的教程里写的是 jammy（22.04 的代号）或者 focal，装上后虽然也能用，但依赖库版本可能不匹配。
2.3 nvm 安装：开发机最灵活
nvm 是 Node.js 社区最流行的版本管理工具，本质是一个 shell 脚本，它把不同版本的 Node.js 安装到 ~/.nvm/versions/node/ 目录下，通过修改 PATH 环境变量来实现版本切换。这种方式的优势是：不需要 sudo 权限、可以同时维护多个 Node 版本、安装新版本对旧环境零影响。
我的习惯是开发机一律用 nvm，因为前端项目太多了，有的要 Node 16，有的要 Node 20，还有的要最新 Node 22 测试特性，nvm 一条命令切来切去非常顺手。而且 nvm 安装的 Node.js 是官方原版二进制，不会有 Debian 修改过的行为差异。服务器上如果有 Docker，也建议在镜像里用 nvm 装 Node，因为 Dockerfile 里可以精确定位版本，又不影响宿主机环境。
安装 nvm 的命令：
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
安装完成后，关掉终端重新打开，或者 source ~/.bashrc 让 nvm 命令生效。然后就可以用了：
bash复制nvm ls-remote # 查看所有可用版本
nvm install 20.11.0 # 安装指定版本
nvm install --lts # 安装最新 LTS 版本
nvm use 20.11.0 # 切换版本
nvm alias default 20.11.0 # 设置默认版本
比较推荐使用 nvm 的另一个原因是 .nvmrc 文件配合 nvm use 命令，可以自动切换 Node 版本。项目根目录放一个 .nvmrc，里面写 20.11.0 或 20，然后终端执行 nvm use，它会自动找到合适的版本并切换。如果是 nvm 没安装的版本，它会提示你是否安装，确认后会自动执行。多项目协作时这个功能非常好用。
注意：nvm 目前只支持 bash、zsh、ksh、dash 这类 POSIX shell，如果你用的是 fish shell，需要额外安装 nvm 的 fish 适配插件（如 fish-nvm，或使用 bass 兼容层）。
2.4 源码编译：不推荐但对理解原理有好处
源码编译就是下载 Node.js 源码包，本地执行 ./configure && make && sudo make install。这种方式需要 GCC、G++、make、python3 等工具链，编译一个 Node.js 在性能好的机器上也要 10 分钟以上，性能差的机器可能得半小时。如果你只是需要装 Node.js，源码编译纯属浪费时间；但如果你是看 Node.js 源码、调试 C++ 插件或者想改 Node 内部实现，那么源码安装就有必要了。
具体步骤如下：
bash复制sudo apt install -y build-essential python3
wget https://nodejs.org/dist/v20.11.0/node-v20.11.0.tar.gz
tar -xzf node-v20.11.0.tar.gz
cd node-v20.11.0
./configure
make -j$(nproc)
sudo make install
编译安装在 Ubuntu 24.04 上踩坑概率不低，比如缺少 libbrotli-dev、libc-ares-dev 之类的依赖会导致某些功能编译不完整，make 时报错又得逐一排查。除非你真的有特殊需求，否则我劝你跳过这条路。
3. 实操过程：nvm 安装的完整记录
这是我 2026 年 2 月初在一台 Ubuntu 24.04 桌面版上的完整实操记录，每一步的坑都会标注出来。
3.1 第一步：安装 nvm
打开终端，先确认 curl 存在：
bash复制which curl
如果没有输出，执行 sudo apt install curl -y。然后执行 nvm 安装脚本：
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
这条命令执行完后，终端会输出类似这样的提示：
code复制=> Downloading nvm as script to '/home/你的用户名/.nvm'
=> Appending nvm source string to /home/你的用户名/.bashrc
=> Close and reopen your terminal to start using nvm
此时如果直接执行 nvm -v，会提示 command not found，因为当前终端的 shell 环境还没有加载 nvm 的初始化脚本。解决方案有二：关闭终端重新打开，或者手动执行 source ~/.bashrc。注意，如果你用的是 zsh，自动追加的是 ~/.zshrc，不是 .bashrc。
3.2 第二步：解决下载慢和连接失败的问题
默认情况下，nvm 从 nodejs.org 下载二进制包，在国内执行 nvm install 20.11.0 时非常容易卡在 Downloading 阶段，要么超时要么速度只有几 KB/s。解决方式是设置镜像环境变量：
bash复制export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
这个命令只对当前终端会话有效，建议写入 ~/.bashrc 的 nvm 初始化代码后面，这样每次打开终端自动生效。设置完镜像后，重新执行 nvm install 20.11.0，下载速度会快很多。
nvm install 执行完毕后，可以验证:
bash复制node -v
npm -v
如果输出版本号，安装成功。顺便说一句，node 和 npm 会一起安装，不需要单独装 npm。npm 的版本通常会跟随 Node 版本一起发布，比如 Node 20.11.0 自带 npm 10.2.4。
3.3 第三步：配置 npm 镜像源
装完 Node.js 之后，下一步就是让 npm 能用起来。默认 npm 官方源的连接速度也是老大难问题。设置镜像源到 npmmirror（淘宝镜像的正式名称）：
bash复制npm config set registry https://registry.npmmirror.com
验证是否生效：
bash复制npm config get registry
输出 https://registry.npmmirror.com 即为成功。这个配置会写入全局的 ~/.npmrc，对所有项目生效。有些教程会让你在项目里再建一个 .npmrc 文件单独指定源，这个在需要发布私有包或者项目有特殊源需求时才需要，大多数情况下全局设置就够了。
进一步加速的话，npm 还支持安装时缓存：
bash复制npm install --cache /tmp/npm-cache
不过当前 npm 版本默认已经有本地缓存，这个参数用的不多。如果你遇到安装某依赖反复失败，倒是可以清缓存试试，命令是 npm cache clean --force。
3.4 第四步：安装常用全局工具
Node.js 环境装好之后，顺手安装一些高频使用的全局工具，可以省掉后续很多麻烦：
bash复制npm install -g yarn pnpm
npm install -g typescript ts-node
npm install -g nodemon
这里我建议全局安装 pnpm，因为现在前端项目用 pnpm 的越来越多，它比 npm 快很多，而且磁盘空间占用小。如果你在公司的项目里还没用过 pnpm，值得一试。yarn 则看你所在团队的偏好，不是必须的。
注意：nvm 方式安装的 Node.js，全局包安装在当前 Node 版本对应的目录下。也就是说，你
nvm use 20.11.0时装的pnpm，切换到 Node 18 后就找不到了，得对每个版本单独装。这是 nvm 的常见坑之一，刚转过来的人经常会一脸懵。
4. 环境变量与版本管理：让 node 和 npm 听话
安装完成只是第一步，真正让人头疼的是环境变量配置和多版本切换，特别是那些之前用 Windows 或者双系统分区的朋友切换到 Ubuntu 之后。这一节单独把环境变量的事说透。
4.1 为什么 node 命令找不到
如果你在终端执行 node -v 报 command not found，但明明已经安装过了，那个大概率是 PATH 环境变量里没有包含 Node.js 可执行文件所在的目录。PATH 是 Linux 系统用来查找可执行文件的目录列表，用 : 分隔。当你在终端敲 node 时，系统会按照 PATH 中列出的目录顺序逐个查找名为 node 的文件，找到就执行，找不到就报错。
nvm 的机制是在 ~/.bashrc 末尾追加了一段函数，让 nvm use 命令动态修改 PATH，把 ~/.nvm/versions/node/v20.11.0/bin 加到最前面。所以如果你发现切了版本但 node -v 没变，八成是 nvm use 之后报错说你指定的版本没安装。手动安装指定版本，或者查看 nvm ls 确认本地有哪些版本。
NodeSource 和 apt 安装的 Node.js 可执行文件在 /usr/bin/node，这个目录一般在 PATH 中默认存在，所以不会出现找不到的问题。但如果你是在 /usr/local/bin 手动放的二进制，而系统的 PATH 没包含这个目录，也会遇到同样的问题。检查 PATH 的命令：
bash复制echo $PATH
看看输出里有没有 /usr/bin、/usr/local/bin、~/.nvm/versions/node/.../bin 这些关键路径。
4.2 如何配环境变量才不会被坑
如果你没有用 nvm，而是手动把 Node.js 二进制解压到某个目录（比如 /opt/nodejs），那么需要自己配置环境变量：
bash复制sudo vim /etc/profile.d/nodejs.sh
写入以下内容：
bash复制export PATH=$PATH:/opt/nodejs/bin
保存后执行 source /etc/profile.d/nodejs.sh 或者重新登录，node -v 就能识别了。这里放到 /etc/profile.d/ 的原因是这个目录下所有 .sh 文件会在用户登录时自动执行，比直接改 /etc/environment 或 /etc/profile 更规范，也更容易管理。
同样的原理适用于 npm 全局包的 bin 目录。npm 在安装全局包时，会创建一个软链接到当前 node 版本的 bin 目录，这个目录如果不在 PATH 里，命令依然找不到。所以装完 Node.js 后，第一件事就是打印一下 PATH，确认 bin 目录在列表里。
4.3 多版本管理：nvm 之外的选择
除了 nvm，还有些开发者在用 fnm（Fast Node Manager）和 volta。fnm 是用 Rust 写的，速度比 nvm 快不少，尤其在切换版本时没有 nvm 的 shell 重新加载延迟。Volta 则是另一个思路，它不只是在 PATH 里切换版本，而是把 Node 和 npm 的版本锁定到项目上，切换项目目录时自动选择对应版本，适合重度项目协作场景。
但要论生态成熟度和教程资源，nvm 依然是最稳的选择。Ubuntu 24.04 上的 nvm 使用体验很好，没遇到过什么致命 bug。如果你对性能特别敏感，可以试试 fnm：
bash复制curl -fsSL https://fnm.vercel.app/install | bash
安装完成后同样需要 source ~/.bashrc，然后 fnm install 20 安装指定版本。fnm 的 shell 集成比 nvm 更干净，命令执行也更快，缺点是新工具，网上的踩坑案例相对少。
5. 常见问题与排查技巧实录
这部分是我在 Ubuntu 24.04 上安装 Node.js 前后遇到的问题汇总，每个问题都给出现象、原因和解决办法，建议收藏备用。
5.1 Ubuntu 24.04 安装时缺少依赖
症状：执行 sudo apt install nodejs npm 时提示依赖无法解决，或者 apt install -f 后仍报错。常见于非纯净系统，尤其是之前装过其他语言环境或开发工具导致 apt 源出现冲突。
排查思路：
bash复制sudo apt update
sudo apt --fix-broken install
第一条命令刷新软件包索引，第二条修复损坏的依赖关系。如果问题还没解决，可以看看是不是有第三方源在 sources.list.d 里冲突了。参考下面的命令检查：
bash复制ls /etc/apt/sources.list.d/
如果看到 nodesource 的旧配置文件和 Ubuntu 的源重复了，把不需要的源删掉再试。最粗暴的方法是注释掉所有非官方源的记录，只保留默认的 ubuntu 源。
5.2 curl 安装 nvm 时报“Failed to connect to raw.githubusercontent.com”怎么办
症状：执行 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/... | bash 时长时间卡住，最终超时或报连接失败。
这种情况多数是网络问题。解决方式：
- 用代理环境变量，比如
export https_proxy=http://127.0.0.1:7890再执行。 - 从 gitee 镜像拉取 nvm 安装脚本（国内镜像）：
bash复制git clone https://gitee.com/mirrors/nvm.git ~/.nvm
cd ~/.nvm
./install.sh
这个镜像仓库的版本可能不是最新的，但核心功能不受影响。装完后再执行 nvm ls-remote 看能不能列出远程版本，如果列表为空还是网络问题，继续配置镜像。
5.3 安装 Node.js 时提示“Cannot find module '../lib/utils/usage'”
这个错误对用过旧版 nvm 的人来说可能不陌生，通常发生在 nvm 升级或切换版本时。原因是 nvm 的脚本目录结构损坏，或者全局 npm 包和当前 Node 版本不一致。
最简单的恢复方式：
bash复制cd ~/.nvm
git pull origin master
如果方法无效，直接备份 ~/.nvm 中的 alias 目录，然后删除整个 ~/.nvm 目录，重新执行安装脚本。注意 nvm 安装的 Node 版本都会保留，删除 ~/.nvm 后版本也会被清掉，需要重新 nvm install。如果想保留版本，只重装 nvm.sh 脚本也行，具体操作可以看 nvm 的官方文档。
5.4 npm 安装包时权限报错
症状：npm install -g xxx 时报 EACCES: permission denied 或者提示无权写入 /usr/lib/node_modules。
根源是 npm 全局包的默认目录写在了系统目录里，当前用户没有写权限。有三种解决方式：
- 使用 nvm 安装 Node.js，全局目录会落到用户目录下，绕开权限问题（推荐）。
- 用
sudo npm install -g强制提权，但这样可能导致之后运行时文件归属不一致，不推荐。 - 手动修改 npm 全局目录到用户目录：
bash复制mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
第 3 种方式在服务器上很常用，因为它不需要 nvm，适合不想引入额外工具的场合。
5.5 apt 和 nvm 双环境并存：node -v 显示版本混乱
有些用户先用了 apt 安装了 Node.js，之后又装了 nvm，两个环境的 PATH 相互干扰，导致终端输出时有时是 apt 版本，有时是 nvm 版本。排查方法：
bash复制which -a node
这个命令会列出所有可用的 node 路径，按 PATH 顺序排列。如果第一个路径是 /usr/bin/node，那 apt 版本优先；如果想优先 nvm 版本，检查 ~/.bashrc 中 nvm 初始化脚本是否在末尾，并确认没有在使用 nvm 后又被其他脚本覆盖 PATH。
实际处理经验是：在纯开发机上，建议 sudo apt remove nodejs npm 把系统版本清掉，只保留 nvm 管理的版本。这样环境简单，不会出现版本漂移问题。如果某个脚本或系统服务依赖 /usr/bin/node 路径，可以建立一个软链指向 nvm 的版本，例如：
bash复制sudo ln -s ~/.nvm/versions/node/v20.11.0/bin/node /usr/bin/node
但要注意，这种方式在 nvm use 切换版本后软链不会自动更新，需要重新执行。所以只适合“永远用某个固定版本”的场景。
5.6 中文显示虚化模糊问题与 Node.js 无关但常被连带提问
当你在 Ubuntu 24.04 上安装各种开发工具时，有时会遇到界面字体虚化模糊的现象，特别是微信 Linux 桌面版这类基于 Web 渲染的应用。这个问题的本质是显示渲染方式差异导致，和 Node.js 安装环境无关。Ubuntu 24.04 使用 Wayland 作为默认显示服务器，对部分 XWayland 应用的支持还不够成熟，可能表现为中文文字边缘发虚。
如果你的应用出现这种问题，可以在应用的启动命令前加上 env GDK_BACKEND=x11 或 env WAYLAND_DISPLAY= 强制应用走 X11 通道来解决。比如微信的启动命令可以改成：
bash复制env GDK_BACKEND=x11 /usr/bin/wechat
不过这个内容超出了 Node.js 的范畴，我这里只是提一嘴，不展开。
6. 升级与卸载：安装之外的必修课
Node.js 安装好后，升级和卸载是绕不开的操作，特别是当你需要在新旧版本之间切换，或者彻底清除环境时。
6.1 nvm 方式升级 Node.js
在 nvm 中升级 Node.js 很直接：
bash复制nvm install 22.0.0
nvm use 22.0.0
nvm alias default 22.0.0
如果想保留旧版本，继续使用 nvm use 切换即可。不要把 nvm alias default 指向不存在的版本，否则新开终端会提示找不到默认版本。
6.2 apt 方式升级 Node.js
如果是 apt 安装的 Node.js，升级方法：
bash复制sudo apt update
sudo apt upgrade nodejs npm
注意，如果是从 NodeSource 仓库安装的，sudo apt upgrade 可能会把 Node.js 升到大版本（比如 20 → 22），但小版本升级需要自行确认仓库中最新版本。有时候 NodeSource 不会立刻把最新小版本推送到 apt 仓库，存在一定滞后，这是正常的。
6.3 如何彻底卸载 Node.js
卸载的方式取决于安装方式：
- apt 方式：
bash复制sudo apt remove nodejs npm -y
如果连配置文件也想删，用 sudo apt purge nodejs npm -y，然后执行 sudo apt autoremove -y 清理依赖。
- nvm 方式：
bash复制nvm uninstall 20.11.0
这会删除指定版本。如果想连 nvm 一起卸载：
bash复制rm -rf ~/.nvm
然后手动编辑 ~/.bashrc，删除 nvm 初始化相关的几行。全局 npm 包等缓存文件在 ~/.npm，一并删除：
bash复制rm -rf ~/.npm
有时候还需要检查系统中残留的软链接、配置文件路径，比如 ~/.config/yarn、~/.config/pnpm 等，有洁癖的话可以一起清理。
6.4 独立 Node.js 二进制的卸载
如果你是通过解压官方二进制包方式安装的（比如解压到 /opt/nodejs），卸载就是把那个目录删掉，然后从 PATH 环境变量配置文件中移除对应行。
bash复制sudo rm -rf /opt/nodejs
sudo rm /etc/profile.d/nodejs.sh
这种方式卸载最干净，没有包管理器留下的依赖问题。
7. 能踩的坑都踩完了，最后说几句体会
安装 Node.js 这件事放在 2026 年来看已经不算什么高难度操作，网上的教程满天飞，但真正能把环境装好并长期稳定使用的人其实不多。很多人卡住的地方不在安装命令本身，而在版本选择、镜像配置、多版本切换这些细节上。回顾这些年帮别人排查 Node.js 环境问题的经验，我最常看到的几个错误：第一，在 Ubuntu 24.04 上用老教程的命令，仓库地址变了或者发行版代号写错，导致 apt 源直接挂掉；第二，装完 Node.js 后忘了配 npm 镜像，后面的包安装一半失败一半超时，还以为是网络大环境的问题；第三，nvm 和 apt 混用，最后不知道当前哪个版本在执行，出了问题也无从查起。
说实话，如果你只是想在 Ubuntu 24.04 上有个能用的 Node.js 环境，不用纠结，直接用 nvm 装一个 LTS 版本就够了。LTS 版本不一定是最新潮的，但它稳定，兼容性最好，遇到的坑最少。2026 年 2 月这个时间点，Node.js 20 是 LTS，Node.js 22 也进入了 LTS，Node.js 24 还在当前版本阶段，个人开发机上选 20 或 22 都不会错。如果后续有特定项目需要，再通过 nvm 补装其他版本即可。这个思路是我用过几年之后总结出来的，适合绝大多数场景。