怎样配置Debian的JS环境变量

在 Debian 上配置 JS 环境变量

一 前置检查与安装

• 更新索引并安装 Node.js 与 npm：
  • sudo apt update
  • sudo apt install -y nodejs npm
• 验证安装结果：
  • node -v
  • npm -v
• 若命令未找到，说明 PATH 未包含 Node.js 可执行文件所在目录，需要先完成 PATH 配置（见下文）。

二 配置 Node.js 与 npm 的可执行文件路径

• 临时生效（当前终端会话）：
  • export PATH=$PATH:/usr/bin:/usr/local/bin
• 永久生效（用户级）：
  • 编辑 ~/.bashrc 或 ~/.zshrc，在末尾追加：
    • export PATH=$PATH:/usr/bin:/usr/local/bin
  • 使配置立即生效：
    • source ~/.bashrc 或 source ~/.zshrc
• 全局生效（系统级，谨慎）：
  • 编辑 /etc/environment，在已有的 PATH 值末尾追加 :/usr/bin:/usr/local/bin
  • 重新加载：source /etc/environment
• 验证：
  • which node、which npm 应返回可执行文件路径
  • node -v、npm -v 正常输出版本号。

三 自定义安装路径与 NPM 全局目录

• 适用于将 Node.js 解压到自定义目录（如 /usr/local/nodejs）或使用版本管理器的场景：
  • 设置环境变量（示例）：
    • echo ‘export NODE_HOME=/usr/local/nodejs’ >> ~/.bashrc
    • echo ‘export PATH=$NODE_HOME/bin:$PATH’ >> ~/.bashrc
    • source ~/.bashrc
  • 配置 npm 全局安装目录（避免 sudo 全局安装）：
    • mkdir -p ~/.npm-global
    • npm config set prefix ‘~/.npm-global’
    • echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc
    • source ~/.bashrc
  • 验证：
    • npm config get prefix 应返回 ~/.npm-global
    • npm list -g --depth 0 可查看全局包。

四 使用 NVM 管理多个 Node.js 版本

• 安装 NVM（Node Version Manager）：
  • curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  • source ~/.bashrc
• 常用命令：
  • nvm install node 或 nvm install 18 或 nvm install 20
  • nvm use node
  • nvm ls
• 说明：NVM 会在用户目录下管理多个 Node.js 版本，并自动设置相应的 PATH，无需手动修改系统级配置。

五 常见问题与排查

• 命令未找到或版本不一致：
  • 执行 echo $PATH，确认包含 /usr/bin、/usr/local/bin 或自定义的 $NODE_HOME/bin、~/.npm-global/bin
  • 重新 source 对应的配置文件，或新开一个终端会话
• 权限错误（全局安装时）：
  • 优先使用 ~/.npm-global 方案，避免向系统目录写入
  • 或确保当前用户对目标目录具备写权限
• 配置未生效：
  • 检查是否在正确的配置文件（~/.bashrc、~/.zshrc、/etc/environment）中追加了路径
  • 对于 /etc/environment，使用 source 使其在当前会话生效，或重新登录系统。