Hermes Agent 运行报错：maven环境变量配置【指南】

答案是Maven环境变量配置失效，需根据shell类型编辑对应配置文件（zsh用户改~/.zshrc，bash用户改~/.bash_profile），正确设置MAVEN_HOME与PATH并执行source生效，再用which mvn和mvn -v验证。

运行Hermes Agent时提示“mvn: command not found”或构建失败，本质是系统找不到Maven可执行文件——这不是代码问题，而是Mac上Maven未被终端识别的典型环境变量配置失效。

确认当前Shell类型并编辑对应配置文件

macOS Monterey（12.0）及之后版本默认使用zsh，但部分用户仍沿用bash；若混用会导致配置不生效。打开终端执行echo $SHELL，输出/bin/zsh则编辑~/.zshrc，输出/bin/bash则编辑~/.bash_profile。

用Cursor或VS Code打开该文件：执行open -e ~/.zshrc（zsh用户）或open -e ~/.bash_profile（bash用户）。

【必须删除旧的重复Maven配置行】——如果之前多次配置过，文件里可能残留多条export MAVEN_HOME=...或export PATH=$MAVEN_HOME/bin:$PATH，只保留最新一条，否则PATH会被覆盖导致失效。

写入正确的MAVEN_HOME和PATH

在配置文件末尾新增两行（注意空格与等号之间不能有空格）：

export MAVEN_HOME=/usr/local/maven

export PATH=$MAVEN_HOME/bin:$PATH

⚠️路径必须与你实际解压Maven的位置完全一致。如果你把Maven解压到了/Users/yourname/main/apache-maven-3.9.9，那就要写成export MAVEN_HOME=/Users/yourname/main/apache-maven-3.9.9。

这一步操作起来很简单，直接复制粘贴即可，但路径写错会导致后续所有验证失败。

使配置立即生效并验证

执行source ~/.zshrc（zsh用户）或source ~/.bash_profile（bash用户）。

运行which mvn，应返回类似/usr/local/maven/bin/mvn的路径；若返回空白，说明配置未生效或路径错误。

再执行mvn -v，看到Apache Maven版本、Java version及Maven home三行输出，即表示Maven已成功接入系统环境。

此时回到Hermes Agent项目根目录，运行mvn clean compile即可正常编译，不再报maven命令找不到错误。