ubuntu上js环境如何配置

Ubuntu 上配置 JavaScript 环境的实用步骤

一 安装 Node.js 与 npm

• 更新索引并安装基础包：
  • sudo apt update
  • sudo apt install -y nodejs npm
• 验证安装：
  • node -v
  • npm -v
• 说明：Ubuntu 官方仓库版本可能偏旧，如需更新或指定版本，见下文更优方案。

二 更优安装方式

• 使用 NodeSource 仓库安装指定或 LTS 版本（推荐）
  • 安装 LTS：
    • 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
  • 验证：node -v、npm -v
• 使用 NVM（Node Version Manager）进行多版本管理（适合开发与测试多版本）
  • 安装 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 install --lts（安装 LTS）
    • nvm alias default 18.16.1（设置默认版本）
    • nvm use 18.16.1（切换版本）
  • 验证：node -v、npm -v。

三 配置 npm 与全局包目录

• 避免全局安装时的权限问题，建议使用用户级目录：
  • mkdir -p ~/.npm-global
  • npm config set prefix ‘~/.npm-global’
• 将全局 bin 目录加入 PATH（写入 ~/.bashrc 或 ~/.zshrc）：
  • echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc
  • source ~/.bashrc
• 可选：配置 npm 镜像加速（提升国内下载速度）
  • npm config set registry https://registry.npmmirror.com
  • npm config get registry（验证）
• 常用全局工具示例：
  • npm install -g yarn pm2 nodemon typescript。

四 创建项目与运行调试

• 初始化项目与运行脚本：
  • mkdir my-js-project && cd my-js-project
  • npm init -y
  • 创建示例文件：echo ‘console.log(“Hello, Ubuntu JS”);’ > index.js
  • 运行：node index.js
• 使用 VS Code 编写与调试
  • 安装 VS Code（.deb 方式）：
    • wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
    • sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/
    • sudo sh -c ‘echo “deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main” > /etc/apt/sources.list.d/vscode.list’
    • sudo apt-get update && sudo apt-get install -y code
  • 在 VS Code 中打开项目，创建 .vscode/launch.json（选择 Node.js 环境），设置断点并启动调试。

五 常见问题与处理

• 命令未找到或版本冲突：优先使用 NVM 管理版本，避免多版本干扰；必要时用 nvm use 切换版本。
• 全局安装报权限错误：改用 ~/.npm-global 方案，不要把全局包装到系统目录。
• 安装原生依赖失败：安装构建工具（如 build-essential），某些包需要编译才能安装。
• 网络慢或超时：设置 npm 镜像（如 npmmirror）或使用国内代理。
• 文件监听数限制（如开发 Vue/React 热更新报 ENOSPC）：
  • echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
  • sudo sysctl -p。