Hermes Agent Git Bash路径空格避坑全攻略

在Git Bash环境下运行Hermes Agent时，不少Windows用户因默认安装路径包含空格（例如C:Program FilesGit）而遭遇故障：Bash进程无法正常启动，hermes doctor命令报错“找不到Git”，甚至直接崩溃。根源在于两点：一是Windows POSIX兼容层解析含空格路径时会出现异常，二是Hermes源代码在拼接路径时缺少引号包裹。简而言之，路径中的空格破坏了所有依赖关系。

以下直接给出排查步骤与修复方案，无需赘言。

诊断Git Bash路径中的空格隐患

启动Git Bash后，执行以下命令：

which bash

观察返回结果。若显示类似/c/Program Files/Git/usr/bin/bash（包含Program Files），则说明安装路径存在空格——该路径极易引发错误，必须立即处理。

接着运行一个更直接的验证：

bash -c "echo hello"

若出现bash: cannot execute binary file: Exec format error错误，或命令无响应直接退出，则表明空格路径导致解析失败——问题确凿。

方案一：重新安装Git至无空格目录（首选）

根治方案是卸载当前Git，然后安装到不含空格的路径中。

首先卸载当前Git for Windows。从官方网站(git-scm.com)下载最新安装包。运行安装程序，在“Select Destination Location”步骤，手动将安装目录改为C:Git，切勿使用默认路径。其余选项保持默认。安装完成后重启Git Bash，执行which bash，应返回/c/Git/usr/bin/bash，确认路径中无空格，问题即被解决。

方案二：利用符号链接绕过空格（适合无法重装的情况）

若因企业策略或权限限制无法重新安装，可使用符号链接来规避问题。

以管理员身份启动PowerShell，运行以下命令：

mklink /J "C:Git" "C:Program FilesGit"

此命令在C盘根目录下创建一个名为Git的Junction目录，指向原安装位置。Junction是Windows原生符号链接，Git Bash能正确解析其目标路径，从而绕过空格限制。

接着设置环境变量，让Hermes使用新的路径：

$env:HERMES_GIT_BASH_PATH="C:Gitusrbinbash.exe"
（在PowerShell中执行）

最后在Git Bash中验证：

hermes doctor

若输出显示✅ Git found (git version x.x.x.windows.x)，则表示已成功绕过空格路径。

方案三：手动为路径添加引号（临时应急）

紧急情况下可直接修改Hermes源码，为路径添加引号。注意这只是临时措施，下次更新时会失效。

导航至Hermes Agent源码目录（一般为~/.hermes/hermes-agent），打开apps/desktop/electron/main.cjs文件。找到findGitBash()函数中所有使用path.join(...)拼接bash.exe的部分，在每个拼接结果首尾添加双引号。示例如下：

原代码：path.join(localAppData,'hermes','git','bin','bash.exe')
改为：""" + path.join(localAppData,'hermes','git','bin','bash.exe') + """

保存文件后重启Hermes桌面应用。请留意：此修改仅作用于当前版本，下次升级Hermes后需重复此操作。