如何在Linux上配置JS开发环境

Linux 上配置 JS 开发环境

一 安装 Node.js 与 npm

• 发行版仓库安装（简单，版本可能偏旧）
  • Ubuntu/Debian

    sudo apt update
    sudo apt install -y nodejs npm
    

  • CentOS/RHEL

    sudo yum update -y
    sudo yum install -y nodejs npm
    

• 使用 NodeSource 仓库安装指定或 LTS 版本（推荐）
  • Ubuntu/Debian

    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
    sudo apt install -y nodejs
    # 或指定 18.x
    # curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
    # sudo apt install -y nodejs
    

  • CentOS/RHEL

    curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
    sudo yum install -y nodejs
    

• 使用 NVM 多版本管理（最灵活，便于切换版本）

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  source ~/.bashrc   # 若使用 zsh 则 source ~/.zshrc
  nvm ls-remote
  nvm install 18.16.1
  nvm alias default 18.16.1
  

• 验证安装

  node -v
  npm -v
  

以上步骤覆盖发行版仓库、NodeSource 与 NVM 三种常见方式，适合新手到进阶用户按需选择。

二 配置 npm 与全局包路径

• 避免 sudo 全局安装，配置用户级全局目录

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

• 国内网络加速（可选）

  npm config set registry https://registry.npmmirror.com
  npm config get registry  # 验证
  

• 常用全局工具

  npm install -g yarn pm2 nodemon typescript
  

• 若采用二进制包解压方式安装，也可直接将解压目录加入 PATH

  echo 'export PATH=/usr/local/nodejs/bin:$PATH' >> ~/.bashrc
  source ~/.bashrc
  

以上配置可有效避免权限问题、提升安装速度，并便于多用户与多项目统一工具链管理。

三 第一个 Node.js 应用与进程守护

• 初始化项目并启动一个 Express 服务

  mkdir myapp && cd myapp
  npm init -y
  npm install express
  cat > app.js <<'EOF'
  const express = require('express');
  const app = express();
  app.get('/', (req, res) => res.send('Hello from Linux & Node.js'));
  app.listen(3000, () => console.log('Server running on http://localhost:3000'));
  EOF
  node app.js
  

• 使用 PM2 守护进程（生产常用）

  npm install -g pm2
  pm2 start app.js --name myapp
  pm2 status
  pm2 logs myapp
  

• 服务器外部访问（云服务器场景）
  • 开放安全组/防火墙的 TCP 3000 端口
  • 浏览器访问：http://服务器公网IP:3000 以上示例覆盖本地开发到云端部署的关键环节，便于快速验证与上线。

四 常见问题与排查

• 命令未找到或版本不对：检查 PATH 是否包含 node 与 npm 所在目录（如 ~/.npm-global/bin 或 /usr/local/nodejs/bin），必要时 source ~/.bashrc 或重登终端。
• 权限错误：优先采用用户级全局目录方案；若已全局安装，谨慎修复目录权限，避免影响系统其他组件。
• 版本冲突：使用 NVM 管理多个 Node 版本，项目根目录放置 .nvmrc 并在部署脚本中 nvm use。
• 网络慢或安装失败：切换 npm 镜像源 至 registry.npmmirror.com，必要时配置企业代理。
• 服务器无法访问：确认云厂商安全组/本机防火墙已放行对应端口（如 3000），服务已启动并监听 0.0.0.0（而非仅 127.0.0.1）。