温馨提示×

ubuntu nodejs怎么配环境变量

小樊
33
2026-09-09 20:34:59
栏目: 编程语言

在 Ubuntu 上配置 Node.js 的环境变量,通常是为了让 nodenpm 等命令能在任意终端/用户下直接使用,或者配置 NODE_HOMENPM_CONFIG_PREFIX 等变量。下面按常见场景说明。


一、通过 apt / 官方包安装(最常见)

如果你是用下面方式安装的:

sudo apt install nodejs npm
# 或
sudo apt install nodejs

一般 已经自动配好 PATH,直接可用:

node -v
npm -v

不需要手动配环境变量


二、使用 NodeSource / 二进制包安装

如果你下载的是官方 .tar.xz 或 NodeSource 版本,例如解压到:

/opt/node-v20.11.0-linux-x64

1️⃣ 临时生效(仅当前终端)

export PATH=/opt/node-v20.11.0-linux-x64/bin:$PATH

2️⃣ 当前用户永久生效

编辑用户环境变量文件:

nano ~/.bashrc

在末尾添加:

export NODE_HOME=/opt/node-v20.11.0-linux-x64
export PATH=$NODE_HOME/bin:$PATH

保存后执行:

source ~/.bashrc

3️⃣ 所有用户生效(推荐服务器)

sudo nano /etc/profile

添加:

export NODE_HOME=/opt/node-v20.11.0-linux-x64
export PATH=$NODE_HOME/bin:$PATH

生效:

source /etc/profile

三、使用 nvm 安装(开发者最常用)

如果你用 nvm

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

nvm 会自动管理 PATH,无需手动配置。

验证:

nvm install 20
nvm use 20
node -v

四、配置 npm 全局路径(可选)

避免权限问题:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

~/.bashrc 添加:

export PATH=~/.npm-global/bin:$PATH

五、验证是否配置成功

which node
which npm
echo $PATH

六、常见问题

command not found: node

  • source
  • PATH 写错路径
  • 非 bash(zsh 要改 ~/.zshrc

如果你愿意,可以告诉我:

  • Ubuntu 版本
  • Node 安装方式(apt / nvm / 二进制)
  • 是否是服务器 / 容器

我可以给你精确配置命令

0