Ubuntu 上配置 Node.js 环境的实用步骤
一 安装方式选择
- 使用 NodeSource APT 仓库：获取较新的 LTS 或指定版本，系统级安装，适合生产环境。
- 使用 NVM（Node Version Manager）：多版本并存与切换，适合开发与测试。
- 使用 Ubuntu 默认仓库：命令最简，但版本通常较旧，适合快速试用。上述三种方式均为常见且可靠的安装路径，可按场景选择。
二 方式一 NodeSource APT 仓库安装（推荐用于生产）
- 更新索引并添加仓库（以 LTS 为例，亦可选择 18.x/20.x 等具体版本）：
- sudo apt update
- curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
- 如需指定版本：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
- 安装 Node.js（同时包含 npm）：sudo apt install -y nodejs
- 验证：node -v 与 npm -v 显示版本号即成功。
三 方式二 使用 NVM 管理多版本（推荐用于开发）
- 安装 NVM（示例版本 v0.39.7，可按需调整）：
- 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 与全局包路径
- 配置国内镜像加速（可选，提升下载速度）：
- npm config set registry https://registry.npmmirror.com
- 验证：npm config get registry
- 避免 sudo 安装全局包（推荐）：
- 创建目录：mkdir ~/.npm-global
- 设置全局安装前缀：npm config set prefix ‘~/.npm-global’
- 将全局 bin 加入 PATH：echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc && source ~/.bashrc
- 常用全局工具示例：npm install -g yarn pm2 nodemon typescript。
五 快速验证与常见问题
- 快速验证示例（创建最小 Express 服务）：
- mkdir myapp && cd myapp
- npm init -y
- npm install express
- 新建 app.js：
- const express = require(‘express’);
- const app = express();
- app.get(‘/’, (req, res) => res.send(‘Hello from Ubuntu Node.js’));
- app.listen(3000, () => console.log(‘Server running on 3000’));
- 启动：node app.js；浏览器访问 http://服务器IP:3000
- 进程守护（生产推荐）：使用 PM2 启动与守护
- 全局安装：npm install -g pm2
- 启动应用：pm2 start app.js --name “myapp”
- 设置开机自启：pm2 startup 并按提示执行命令
- 常用：pm2 list、pm2 logs、pm2 restart myapp
- 常见问题处理：
- 命令未找到：确认 PATH 包含 ~/.nvm/versions/node/*/bin（NVM）或 ~/.npm-global/bin（自定义全局路径），并执行 source 相应配置文件。
- 端口无法访问（云服务器）：在 安全组/防火墙 放行对应端口（如 3000），或临时关闭防火墙测试。
- 多版本并存冲突：优先使用 NVM 隔离版本，避免系统级多版本互相干扰。