配置Node.js环境变量的核心目标是将Node.js和npm的可执行文件路径添加到系统PATH环境变量中,从而实现在任意终端会话中直接运行node和npm命令。以下是具体步骤(以常见的~/.bashrc文件为例,若使用Zsh需替换为~/.zshrc):
在配置环境变量前,需明确Node.js的可执行文件路径。常用命令如下:
which node # 查看Node.js可执行文件路径(如/usr/bin/node)
which npm # 查看npm可执行文件路径(如/usr/bin/npm)
若通过官方APT仓库或NodeSource仓库安装,路径通常为/usr/bin/node和/usr/bin/npm;若通过NVM安装,路径可能为~/.nvm/versions/node/<version>/bin/node。
选择对应的Shell配置文件(.bashrc适用于Bash,.zshrc适用于Zsh),使用文本编辑器(如nano)打开文件:
nano ~/.bashrc # 若使用Zsh,替换为nano ~/.zshrc
在文件末尾添加以下内容(将/usr/bin替换为实际的Node.js路径,若路径包含node和npm,只需添加父目录即可):
export PATH="$PATH:/usr/bin" # 将/usr/bin添加到PATH环境变量
注意:若Node.js安装在自定义路径(如/opt/nodejs/bin),需替换为对应路径:
export PATH="/opt/nodejs/bin:$PATH"
保存并关闭文件(nano中按Ctrl+O保存,Ctrl+X退出)。
运行以下命令使修改后的配置文件生效:
source ~/.bashrc # 若使用Zsh,替换为source ~/.zshrc
通过以下命令检查node和npm的版本,若显示版本号则说明配置成功:
node -v # 查看Node.js版本
npm -v # 查看npm版本
默认情况下,NPM全局模块安装在/usr/local/lib/node_modules(需root权限),可通过以下步骤修改为当前用户目录:
mkdir ~/.npm-global # 创建全局模块目录
npm config set prefix '~/.npm-global' # 设置npm前缀为用户目录
然后,在~/.bashrc(或~/.zshrc)中添加以下内容,将全局模块路径加入PATH:
export PATH=~/.npm-global/bin:$PATH
运行source ~/.bashrc使配置生效,此后使用npm install -g安装的全局模块将存放在~/.npm-global目录下,无需root权限。
若需要灵活切换Node.js版本,推荐使用nvm(Node Version Manager)。NVM会自动处理环境变量配置,无需手动修改:
# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
# 激活nvm
source ~/.nvm/nvm.sh
# 安装Node.js(如LTS版本)
nvm install --lts
# 切换版本(如切换到18.x)
nvm use 18
使用nvm安装的Node.js,其路径会自动添加到PATH中,无需额外配置。
通过以上步骤,你可以在Ubuntu上完成Node.js环境变量的配置,实现随时随地运行Node.js和npm命令。