macOS HBuilderX 运行 uniapp 报错缺少 Node.js 环境解决方案

问题描述

在 macOS 上使用 HBuilderX 运行 uni-app 项目时，即使终端能正常执行 node -v，HBuilderX 仍提示缺少 Node.js 环境。这是因为 HBuilderX 启动时未继承当前用户的环境变量。

解决方案

1. 通过终端启动 HBuilderX

在终端中直接调用应用，使其继承当前 Shell 的环境变量：

open /Applications/HBuilderX.app

2. 配置 Shell 环境变量

确保 HBuilderX 能够读取 Node.js 路径。如果你使用 nvm，需确保 .bash_profile 或 .zshrc 配置正确。

编辑配置文件：

vim ~/.bash_profile

添加以下内容（以 nvm 为例）：

# nvm 环境
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \.
 "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \.
 "$NVM_DIR/bash_completion"

保存后生效配置：

source ~/.bash_profile

*注意：macOS Catalina (10.15) 及以上版本默认使用 zsh，建议检查 ~/.zshrc 并同步配置，或将其复制到 ~/.bash_profile。

3. 手动指定 Node 路径

若上述方法无效，可在 HBuilderX 设置中手动配置：

1. 打开 HBuilderX，进入 偏好设置 > 运行设置。
2. 配置 Node 路径 为实际安装位置（例如 /usr/local/bin/node）。
3. 将运行终端类型选择为 '外部终端'。

或者直接在配置文件中添加：

export PATH=$PATH:/usr/local/bin/node

然后重启终端或执行 source ~/.bash_profile 验证 bash --login -c "node -v"。