Linux 安装 Node 环境

适用范围

• Ubuntu / Debian

• CentOS / Rocky / AlmaLinux

• 建议安装 Node.js 20 LTS（长期支持版本）

方案一：使用 nvm（推荐）

优点：

• 可同时管理多个 Node 版本

• 切换版本方便

• 不污染系统全局环境

1. 安装 nvm

curl-fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

2. 让当前 shell 立即生效

exportNVM_DIR="$HOME/.nvm"[ -s"$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

也可以重新登录 SSH。

3. 安装 Node 20 LTS

nvm install 20nvm use 20nvm alias default 20

4. 验证

node-vnpm-v

方案二：系统包管理器安装

说明：

• 适合不想使用 nvm 的场景

• 版本通常受发行版仓库影响，可能不是最新

Ubuntu / Debian

sudo apt updatesudo apt install -y nodejs npmnode-vnpm-v

CentOS / Rocky / AlmaLinux

sudo dnf install -y nodejs npmnode-vnpm-v

安装 pnpm（可选）

如果项目使用 pnpm，建议用 corepack：

corepack enablecorepack prepare pnpm@latest --activatepnpm -v

常见问题

1. 提示 nvm: command not found

执行：

exportNVM_DIR="$HOME/.nvm"[ -s"$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

并确认 ~/.bashrc 或 ~/.zshrc 已写入 nvm 初始化脚本。

2. curl 不存在

Ubuntu / Debian：

sudo apt install -ycurl

CentOS / Rocky / AlmaLinux：

sudo dnf install -ycurl

3. Node 版本不对

使用 nvm 时可执行：

nvm lsnvm use 20

项目建议

• 生产环境建议固定 Node 主版本（如 20）

• 在项目中增加 .nvmrc，内容写 20

• 部署脚本中先校验 node -v 再启动服务