如何在Debian配置Nodejs

在 Debian 系统上配置 Node.js 有多种方式，推荐优先使用 NodeSource 或 nvm，具体取决于你是“系统级使用”还是“开发环境”。下面按常用方式详细说明。

一、方式一：使用 NodeSource（推荐，系统级安装）

适合：服务器、生产环境

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装依赖

sudo apt install -y curl ca-certificates gnupg

3. 导入 NodeSource GPG 密钥

curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg

4. 添加 Node.js 仓库（以 Node.js 20.x 为例）

NODE_MAJOR=20
echo "deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

5. 安装 Node.js

sudo apt update
sudo apt install -y nodejs

6. 验证

node -v
npm -v

二、方式二：使用 nvm（推荐，开发环境）

适合：前端 / 后端开发，多版本切换

1. 安装 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

或使用 wget：

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

2. 重新加载 shell

source ~/.bashrc
# 或
source ~/.zshrc

3. 安装 Node.js

nvm install --lts

或指定版本：

nvm install 20

4. 设置默认版本

nvm alias default 20

5. 验证

node -v
npm -v

三、方式三：使用 Debian 官方仓库（不推荐）

版本通常较旧：

sudo apt update
sudo apt install -y nodejs npm

查看版本：

node -v

⚠️ Debian 12 之前版本 Node.js 可能低于 18，不建议用于现代项目。

四、配置 npm（可选但推荐）

1. 避免 sudo 安装全局包

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

2. 换国内镜像（如淘宝源）

npm config set registry https://registry.npmmirror.com

五、验证环境是否正常

node -e "console.log('Node.js 配置成功')"

六、常见问题

1. node 命令不存在？

• 检查 PATH
• 确认安装方式
• nvm 用户需重新登录或 source ~/.bashrc

2. 权限问题？

• 不要用 sudo npm install -g
• 使用 npm prefix 或 nvm

七、推荐选择总结

如果你愿意，可以告诉我：

• Debian 版本（如 11 / 12）
• 用途（前端 / 后端 / 服务器）
• 是否需要 PM2、Docker、Nginx 配合

我可以给你一套完整部署方案。