如何在Debian系统中安装Node.js

在 Debian 上安装 Node.js 的三种常用方法

方法一 使用 NodeSource 仓库安装指定版本

• 更新索引并安装必要工具：
  • sudo apt update
  • sudo apt install -y ca-certificates curl gnupg
• 导入 NodeSource GPG 密钥并添加仓库（示例为 Node.js 20.x，如需其他版本将 20.x 替换为目标版本号）：
  • curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg
  • echo “deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x $(lsb_release -sc) main” | sudo tee /etc/apt/sources.list.d/nodesource.list > /dev/null
• 安装 Node.js（同时包含 npm）：
  • sudo apt update
  • sudo apt install -y nodejs
• 验证：
  • node -v
  • npm -v
• 说明：NodeSource 提供脚本化方式添加仓库，适合需要较新或特定 LTS/Current 版本的开发者与运维场景。

方法二 使用 NVM 管理多版本 Node.js（推荐开发环境）

• 安装 NVM（Node Version Manager）：
  • curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
• 重新加载 Shell 配置（或新开终端）：
  • source ~/.bashrc
• 安装与切换版本：
  • nvm install --lts（安装最新 LTS）
  • nvm install 20（安装指定主版本）
  • nvm use 20
  • nvm alias default 20（设置默认版本）
• 验证：
  • node -v
  • npm -v
• 说明：NVM 可在同一台机器上并行管理多个 Node.js 版本，便于开发与测试不同项目需求。

方法三 使用 Debian 官方仓库安装稳定版

• 更新索引并安装：
  • sudo apt update
  • sudo apt install -y nodejs npm
• 验证：
  • node -v
  • npm -v
• 说明：适合追求稳定与系统一致性、对版本要求不高的场景；但官方仓库版本可能较旧。

安装后配置与常见问题

• 升级 npm 到最新版：
  • npm install -g npm@latest
• 使用国内镜像源加速（可选，提升依赖安装速度）：
  • npm config set registry https://registry.npmmirror.com
• 全局包权限建议：
  • 优先使用项目本地安装（npm ci / npm install），或使用 nvm/构建工具链避免以 root 全局安装；如必须全局安装，可配置 npm 使用用户目录或采用合适的权限方案。
• 多版本并存与切换：
  • 使用 NVM 的 nvm use、nvm alias default 等命令进行版本切换与默认版本设置。
• 验证命令汇总：
  • node -v、npm -v、nvm --version（如使用 NVM）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！