如何在Linux上配置JS运行环境

在 Linux 上配置 JavaScript 运行环境

一 安装 Node.js 的三种常用方式

• 系统包管理器安装（适合新手、稳定）
  • Ubuntu/Debian

    sudo apt update
    sudo apt install -y nodejs npm
    

  • CentOS/RHEL（启用 EPEL 后）

    sudo yum install -y epel-release
    sudo yum install -y nodejs npm
    

  • Fedora

    sudo dnf install -y nodejs npm
    

• NodeSource 仓库安装（获取更新或指定版本）
  • Ubuntu/Debian（示例为 20.x，可替换为 18.x/22.x）

    curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
    sudo apt-get install -y nodejs
    

  • CentOS/RHEL（示例为 20.x）

    curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
    sudo yum install -y nodejs    # 或 dnf install -y nodejs
    

• NVM 安装（强烈推荐，便于多版本切换）

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
  source ~/.bashrc   # 或 source ~/.zshrc
  nvm install --lts   # 安装最新 LTS
  nvm use --lts       # 使用 LTS
  

安装完成后验证：

node -v
npm -v

以上方法覆盖主流发行版与常见场景，选择其一即可完成基础运行环境搭建。

二 配置与优化

• 配置 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 install -g yarn pnpm nodemon pm2
  

• 多版本管理建议
  • 使用 NVM 管理多个 Node 版本；在项目中放置 .nvmrc 记录版本，进入项目后执行 nvm use 自动切换。 以上优化能显著改善日常开发与部署体验。

三 运行与验证

• 运行脚本

  node -v
  npm -v
  echo "console.log('Hello Node');" > test.js
  node test.js
  

• 简单 HTTP 服务示例

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

在浏览器访问 http://localhost:3000 验证服务是否正常。

四 常见问题与处理

• 命令找不到或版本冲突
  • 使用 NVM 重装/切换版本：nvm install 18 && nvm use 18；检查 which node 与 which npm 是否一致。
• 全局安装权限错误
  • 采用上一节的“npm 全局目录”方案，避免使用 sudo npm -g。
• 旧版系统仓库版本过旧
  • 优先使用 NodeSource 仓库或 NVM 安装较新或 LTS 版本。
• 网络下载慢或失败
  • 配置 npm 国内镜像源：npm config set registry https://registry.npmmirror.com。
• 需要定时执行脚本
  • 使用系统计划任务（如 crontab -e）调用 node /path/script.js，并将日志重定向到文件以便排查。 以上做法覆盖最常见的安装、权限、版本与网络问题。