ubuntu里nodejs怎么配置
小樊
35
2025-11-24 11:07:29
Ubuntu 下 Node.js 配置全流程
一 安装方式选择
- 使用 APT 官方仓库:命令少、适合快速上手,但版本可能偏旧。
- 使用 NodeSource APT 仓库:可安装指定 LTS 或最新版本,兼顾易用与版本新。
- 使用 nvm(Node Version Manager):在同一台机器管理多个 Node.js 版本,开发最灵活。
- 使用 Docker:以容器隔离环境,适合一致性与可移植性要求高的场景。
二 安装与基础配置
- APT 官方仓库(快速)
- 更新索引并安装
sudo apt update
sudo apt install -y nodejs npm
- 验证
node -v
npm -v
- NodeSource APT 仓库(指定版本)
- 添加仓库(示例为 18.x,可按需替换为 16.x/20.x 等)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
- 安装
sudo apt-get install -y nodejs
- 验证
node -v
npm -v
- nvm(多版本管理,推荐开发)
- 安装 nvm(脚本版本号可按需更新)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
- 使配置生效
source ~/.bashrc 或 source ~/.profile
- 安装与切换版本
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。
- 创建目录
mkdir -p ~/.npm-global
- 配置 npm 前缀
npm config set prefix ‘~/.npm-global’
- 将全局 bin 加入 PATH(针对 bash;如使用 zsh 则写入 ~/.zshrc)
echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc
source ~/.bashrc
- 验证
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 清理,再按所需方式安装。