Ubuntu系统下Node.js环境变量的配置方法

作者：袖梨 2026-06-07

Node.js在Ubuntu上的环境变量设置指南

在Ubuntu系统中配置Node.js环境变量，核心目标是让系统在任何目录下都能识别node、npm（及全局安装的包命令），以下是详细步骤：

在配置环境变量前，需确保Node.js已正确安装。可通过以下命令验证：

node --version# 查看Node.js版本npm --version # 查看npm版本

若显示版本号（如v20.12.2、10.8.1），说明已安装；若未安装，可通过以下方式安装：

通过包管理器安装（推荐）：

sudo apt updatesudo apt install nodejs npm

需获取node和npm的可执行文件路径，用于添加到环境变量。常用命令：

which node# 查找node路径（如/usr/bin/node）which npm # 查找npm路径（如/usr/bin/npm）whereis node# 同时查找node相关文件（更全面）

若通过包管理器安装，路径通常为/usr/bin/node或/usr/bin/npm；若通过源码编译安装，可能在/usr/local/bin/node。

Ubuntu默认使用bash shell，配置文件为~/.bashrc（用户级）；若使用zsh，则编辑~/.zshrc。也可选择系统级配置文件/etc/profile（需管理员权限）。

编辑用户级配置文件（推荐）：

nano ~/.bashrc# 用nano编辑器打开（也可用vim/vi）

在文件末尾添加以下内容（将路径替换为实际安装路径）：

# 添加Node.js及npm所在目录到PATHexport PATH=$PATH:/usr/bin# 若路径为/usr/bin# 若为其他路径（如/opt/nodejs/bin），替换为对应路径# export PATH=$PATH:/opt/nodejs/bin

注意：无需单独添加node或npm的路径（因它们已在/usr/bin等系统路径中），只需确保PATH包含这些目录即可。

保存配置文件后，需重新加载以应用更改：

source ~/.bashrc# 用户级配置# 或source /etc/profile# 系统级配置

也可关闭终端并重新打开，效果相同。

运行以下命令，检查是否能识别node和npm命令：

node -v# 应显示Node.js版本号npm -v # 应显示npm版本号

若显示版本号，说明配置成功。

默认情况下，npm install -g安装的全局模块位于/usr/local/lib/node_modules（需root权限）。若想将全局模块安装到用户目录（避免权限问题），可按以下步骤操作：

创建全局模块目录：
```
mkdir ~/.npm-global
```
配置npm使用新目录：
```
npm config set prefix '~/.npm-global'
```
更新环境变量：在~/.bashrc或~/.profile中添加：
```
export PATH=~/.npm-global/bin:$PATH
```
使更改生效：
```
source ~/.bashrc
```

此后，npm install -g安装的模块将存放在~/.npm-global目录，且无需root权限即可使用。