Node.js 安装指南（Ubuntu/Debian）
为什么不能用
sudo apt install nodejs？因为版本太老了！
问题诊断
❌ 错误方式
sudo apt install nodejs npm
问题：
- Ubuntu 20.04 官方源：Node.js v10.x（2018年发布）
- Ubuntu 22.04 官方源：Node.js v12.x（2019年发布）
- Ubuntu 24.04 官方源：Node.js v18.x（勉强够用，但不是最新）
chrome-devtools-mcp 需要：Node.js ≥18
✅ 正确方式：使用 NodeSource 官方源
方法1：一键安装（推荐）
# 安装 Node.js 20.x（LTS 版本，推荐）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version # 应该显示 v20.x.x
npm --version # 应该显示 v10.x.x
方法2：使用国内镜像（网络不好时）
# 使用阿里云镜像
curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version
npm --version
升级已有的旧版本
步骤1：检查当前版本
node --version
如果显示 v10.x、v12.x、v14.x、v16.x，需要升级。
步骤2：卸载旧版本
sudo apt remove nodejs npm
sudo apt autoremove
步骤3：安装新版本
# 使用 NodeSource 官方源
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证
node --version # 应该显示 v20.x.x
版本选择
| 版本 | 状态 | 推荐场景 | 安装命令 |
|---|---|---|---|
| Node.js 20.x | LTS（长期支持） | ✅ 生产环境、日常使用 | setup_20.x |
| Node.js 22.x | Current（最新） | 尝鲜、测试新特性 | setup_22.x |
| Node.js 18.x | LTS（维护中） | 兼容性要求高的项目 | setup_18.x |
推荐：使用 Node.js 20.x（LTS）
常见问题
Q1: curl: command not found
sudo apt update
sudo apt install curl
Q2: 安装脚本下载失败
原因： 网络问题或 GFW
解决： 使用国内镜像
# 阿里云镜像
curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash -
sudo apt-get install -y nodejs
Q3: npm 权限错误
# 问题：npm install -g 提示权限错误
npm install -g some-package
# Error: EACCES: permission denied
# 解决方案1：配置 npm 全局目录（推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# 解决方案2：使用 sudo（不推荐）
sudo npm install -g some-package
Q4: 如何切换 Node.js 版本？
使用 nvm（Node Version Manager）：
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
# 安装多个版本
nvm install 20
nvm install 18
# 切换版本
nvm use 20
nvm use 18
# 设置默认版本
nvm alias default 20
Q5: 卸载 Node.js
# 卸载通过 apt 安装的 Node.js
sudo apt remove nodejs npm
sudo apt autoremove
# 清理 NodeSource 源
sudo rm -f /etc/apt/sources.list.d/nodesource.list
sudo apt update
# 清理用户数据
rm -rf ~/.npm
rm -rf ~/.nvm
验证安装
完整检查清单
# 1. 检查 Node.js 版本
node --version
# 预期：v20.x.x 或更高
# 2. 检查 npm 版本
npm --version
# 预期：v10.x.x 或更高
# 3. 检查 npx
npx --version
# 预期：v10.x.x 或更高
# 4. 测试运行
node -e "console.log('Node.js 工作正常！')"
# 预期：输出 "Node.js 工作正常！"
# 5. 测试 npm
npm --version
# 预期：显示版本号
# 6. 测试全局安装（可选）
npm install -g cowsay
cowsay "安装成功！"
npm uninstall -g cowsay
为什么选择 NodeSource？
| 对比项 | Ubuntu 官方源 | NodeSource 官方源 |
|---|---|---|
| 更新速度 | ❌ 慢（跟随 Ubuntu 发布周期） | ✅ 快（跟随 Node.js 发布） |
| 版本 | ❌ 老旧（v10-v18） | ✅ 最新（v18-v22） |
| 安全更新 | ✅ 有 | ✅ 有 |
| 稳定性 | ✅ 高 | ✅ 高 |
| 官方支持 | ❌ 社区维护 | ✅ Node.js 官方认可 |
结论：NodeSource 是 Ubuntu/Debian 上安装 Node.js 的最佳方式。
快速命令参考
# 安装 Node.js 20.x（推荐）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs
# 国内镜像版本
curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash - && sudo apt-get install -y nodejs
# 升级已有版本
sudo apt remove nodejs npm && sudo apt autoremove && curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs
# 验证安装
node --version && npm --version
参考资源
- NodeSource 官方仓库： github.com/nodesource/…
- Node.js 官网： nodejs.org/
- Node.js 发布计划： github.com/nodejs/rele…
- 阿里云镜像： developer.aliyun.com/mirror/
"Don't use the distro Node.js. It's always outdated."
— 每个遇到过版本问题的开发者
