ubuntu里nodejs怎么配置

Ubuntu 下 Node.js 配置全流程

一 安装方式选择

• 使用 APT 官方仓库：命令少、适合快速上手，但版本可能偏旧。
• 使用 NodeSource APT 仓库：可安装指定 LTS 或最新版本，兼顾易用与版本新。
• 使用 nvm（Node Version Manager）：在同一台机器管理多个 Node.js 版本，开发最灵活。
• 使用 Docker：以容器隔离环境，适合一致性与可移植性要求高的场景。

二 安装与基础配置

• APT 官方仓库（快速）
  1. 更新索引并安装
     sudo apt update
     sudo apt install -y nodejs npm
  2. 验证
     node -v
     npm -v
• NodeSource APT 仓库（指定版本）
  1. 添加仓库（示例为 18.x，可按需替换为 16.x/20.x 等）
     curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
  2. 安装
     sudo apt-get install -y nodejs
  3. 验证
     node -v
     npm -v
• nvm（多版本管理，推荐开发）
  1. 安装 nvm（脚本版本号可按需更新）
     curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
  2. 使配置生效
     source ~/.bashrc 或 source ~/.profile
  3. 安装与切换版本
     nvm install --lts # 安装最新 LTS
     nvm use --lts # 使用 LTS
     nvm ls # 查看已安装版本
     nvm alias default # 设置默认版本
• Docker（环境隔离）
  • 运行交互式容器并挂载当前目录
    docker run -it --rm -v $(pwd):/usr/src/app -w /usr/src/app node:18 bash

三 npm 全局包目录与权限

• 建议将全局包安装到用户目录，避免每次使用 sudo。
  1. 创建目录
     mkdir -p ~/.npm-global
  2. 配置 npm 前缀
     npm config set prefix ‘~/.npm-global’
  3. 将全局 bin 加入 PATH（针对 bash；如使用 zsh 则写入 ~/.zshrc）
     echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc
     source ~/.bashrc
  4. 验证
     npm config get prefix
     which npm
• 之后可无 sudo 安装全局工具：
  npm install -g pm2 nodemon

四 常用优化与常用命令

• 使用国内镜像源加速（可选）
  npm config set registry https://registry.npmmirror.com
  npm config get registry
• 版本控制与切换（nvm）
  nvm install 18.17.0 # 安装指定版本
  nvm use 18.17.0 # 临时切换
  nvm alias default 18.17.0 # 设为默认
  nvm ls-remote --lts # 查看可安装的 LTS 版本
• 运行与守护
  node app.js # 直接运行
  pm2 start app.js --name myapp # 进程守护与开机自启（需全局安装 pm2）

五 常见问题排查

• 命令未找到：检查 PATH 是否包含 node 与 npm 所在目录（如 ~/.npm-global/bin 或 /usr/bin），必要时在 ~/.bashrc 或 ~/.zshrc 中修正并 source 重载。
• 多版本冲突：使用 nvm 的 nvm use/nvm alias default 固定项目所需版本，避免系统多源安装导致冲突。
• 权限错误：优先采用用户级全局目录方案（见第三节），尽量避免 sudo npm -g。
• 旧版本残留：切换或重装前可 sudo apt remove --purge nodejs 清理，再按所需方式安装。