当前位置：首页 > news >正文

macos HbuildX 使用cli脚本创建uniapp 运行时报错“cli项目运行依赖本地的Nodejs环境，请先安装并配置到系统环境变量后重试。”

news 2025/11/14 5:59:44

在官网描述中，有两种方式启动uniapp，我使用的是vue-cli，但是在运行的时候，显示缺少node环境，但是本地终端执行node -v是有的
请添加图片描述

方法一：在终端启动hbuildX

最终解决办法：在终端启动hbuildX

 open /Applications/HBuilderX.app

方法二：编辑~/.bash_profile

还有一个我测试之后也是可以正常运行的，因为我使用的是nvm
终端运行

vim ~/.bash_profile

打开之后新增

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

保存退出后执行

source ~/.bash_profile

其他方法

网上还有其他方法，我这里列举一些，大家根据自己情况选择合适的（我测试了是不太行，但有人说可以）

因为在 macOS 中，默认的终端应用程序通常使用的是 zsh（从 macOS Catalina 10.15 起，zsh 成为默认的 shell），需要配置bash环境变量，所以把.zshrc文件复制一份执行

cp ~/.zshrc ~/.bash_profile，然后再 source ~/.bash_profile

按照官网提示导入node地址
https://hx.dcloud.net.cn/Tutorial/configureEnvironmentVariables

查找node地址
which nodevim ~/.bash_profile在最后一行
export PATH=$PATH:刚才的地址保存退出后执行
source ~/.bash_profile验证
bash --login -c "node -v"

hBuilderX设置
右上角->偏好设置->运行设置->配置node路径，同时运行终端类型选择“外部终端”
回退版本
https://pan.baidu.com/s/1kvigifhSaEImD-gCx_DQ8Q#list/path=%2Fsharelink291282757-664376222114347%2FHBuilderX&parentPath=%2Fsharelink291282757-664376222114347
bash_profile 中增加