Debian 安装 Node.js 环境
方法一 使用 NodeSource 仓库安装指定版本
- 适合需要在系统层面安装并长期维护某个版本的 LTS 或最新稳定版的用户。
- 步骤：
- 安装必要工具并导入 NodeSource GPG 密钥
sudo apt update
sudo apt install -y ca-certificates curl gnupg
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
- 选择版本并添加仓库（示例为 Node.js 20.x）
NODE_MAJOR=20
echo “deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main” | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt update
- 安装 Node.js
sudo apt install -y nodejs
- 验证
node -v
npm -v
- 如需 Node.js 18.x/22.x，将上面的 NODE_MAJOR 改为 18 或 22 后重复步骤 2–4。
方法二 使用 NVM 管理多版本
- 适合开发者在同一台机器上切换多个 Node.js 版本（如 LTS 与最新版并存）。
- 步骤：
- 安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
- 安装与切换版本
nvm install --lts # 安装最新 LTS
nvm install 20 # 安装指定主版本
nvm use 20
nvm alias default 20 # 设置默认版本
- 验证
node -v
npm -v
方法三 使用系统仓库安装
- 适合追求开箱即用、对版本要求不高的场景（版本通常较旧）。
- 步骤：
sudo apt update
sudo apt install -y nodejs npm
node -v
npm -v
安装后配置与常见问题
- 配置 npm 镜像源（提升国内下载速度）
npm config set registry https://registry.npmmirror.com
- 全局包目录权限（避免每次 sudo）
mkdir -p ~/.npm-global
npm config set prefix ‘~/.npm-global’
echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc
source ~/.bashrc
- 升级 npm
npm install -g npm@latest
- 常见冲突处理
- 若安装时出现文件冲突（如与旧版 libnode 冲突），先卸载再装：
sudo apt-get remove --purge nodejs libnode72
sudo apt-get autoremove
sudo apt-get install -y nodejs
- 简单验证示例
mkdir -p ~/myapp && cd $_
npm init -y
cat > app.js <<‘EOF’
const http = require(‘http’);
http.createServer((_, res) => res.end(‘Hello World\n’)).listen(3000, () => console.log(‘http://127.0.0.1:3000’));
EOF
node app.js
