温馨提示×

centos如何配置nodejs环境变量

小樊
52
2026-07-08 05:56:09
栏目: 编程语言

在 CentOS 上配置 Node.js 环境变量,常见做法有 系统级配置用户级配置。下面按最常见的几种方式说明(以 Node.js 16 为例,目录可按你实际安装路径调整)。


一、确认 Node.js 安装方式

方式 1:通过 二进制包 安装(推荐)

例如下载并解压到:

/usr/local/node-v16.20.2-linux-x64

方式 2:通过 nvm 安装(最省事)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 16
nvm use 16

如果用 nvm,不需要手动配置环境变量,nvm 会自动处理。


二、手动配置 Node.js 环境变量(二进制安装)

1️⃣ 找到 Node.js 安装路径

假设解压在:

/usr/local/node-v16.20.2-linux-x64

确认路径:

ls /usr/local/node-v16.20.2-linux-x64/bin

应该能看到:

node  npm  npx

2️⃣ 配置环境变量(推荐方式)

✅ 系统级(所有用户)

sudo vim /etc/profile

在文件末尾添加:

export NODE_HOME=/usr/local/node-v16.20.2-linux-x64
export PATH=$NODE_HOME/bin:$PATH

保存后执行:

source /etc/profile

✅ 用户级(仅当前用户)

vim ~/.bashrc

添加:

export NODE_HOME=/usr/local/node-v16.20.2-linux-x64
export PATH=$NODE_HOME/bin:$PATH

生效:

source ~/.bashrc

3️⃣ 验证是否成功

node -v
npm -v

输出类似:

v16.20.2
8.19.4

✅ 说明环境变量配置成功。


三、如果是通过 yum / dnf 安装的 Node.js

sudo yum install -y nodejs

或:

sudo dnf install nodejs

无需手动配置环境变量

验证:

node -v

四、常见问题排查

node: command not found

原因:

  • PATH 没生效
  • 路径写错

解决:

echo $PATH
which node

❌ sudo 下 node 不可用

原因:sudo 不会加载用户环境变量

解决(任选一种):

  1. 使用绝对路径
  2. sudo -E
  3. 把 node 软链接到 /usr/bin
sudo ln -s /usr/local/node-v16.20.2-linux-x64/bin/node /usr/bin/node
sudo ln -s /usr/local/node-v16.20.2-linux-x64/bin/npm /usr/bin/npm

五、推荐方案总结

场景 推荐方式
新手 / 多版本 ✅ nvm
服务器生产环境 ✅ 二进制 + 环境变量
快速安装 ✅ yum / dnf

如果你愿意,可以把 你的 CentOS 版本Node.js 安装方式 发我,我可以给你一份完全适配你环境的配置命令

0