Git merge conflict automatic failed 错误码128怎么排查？

Git merge 报"Automatic merge failed"通常只是内容冲突，但若伴随退出码 128，说明 Git 底层执行中断。优先检查本地配置文件语法、SSH 认证状态及远程仓库权限，而非直接解决代码冲突。

先说结论：退出码 128 代表致命错误，并非普通代码冲突，需优先排查环境配置。

命令速用版

以下命令用于快速定位配置和网络问题，建议在 Git Bash 或终端中执行：

git config `--list` `--show-origin`
ssh -T git@github.com
git remote -v
git status

退出码 128 是 Git 通用致命错误码，表示命令无法完成底层操作。普通合并冲突通常返回退出码 1，而 128 常由配置文件损坏、认证失败或路径权限问题触发。当 Git 无法读取配置、无法连接远程仓库或无法写入对象文件时，会直接终止进程并返回 128，此时合并流程甚至无法开始。

按以下顺序排查，每步完成后尝试重新执行 merge 操作：

1. 检查 Git 配置文件语法
错误常出现在全局配置文件 `.gitconfig` 的第一行，如缺少节头声明。打开文件检查是否有乱码或格式错误，若无法修复可重命名备份后重新生成。
操作：查找 `.gitconfig` 文件，确认格式正确。

2. 清除缓存的认证凭据
若远程仓库密码变更，本地缓存的旧凭据会导致认证失败。Windows 用户可通过控制面板的"凭据管理器"删除对应 Git 地址的保存密码。
操作：控制面板 > 凭据管理器 > Windows 凭据 > 删除对应 Git 条目。

3. 验证 SSH 或 HTTPS 连接
确认远程 URL 配置正确且网络可达。SSH 用户需确保密钥已加载至 ssh-agent，HTTPS 用户需确认网络代理设置未拦截请求。
操作：运行 `ssh -T git@github.com` 或检查 `git remote -v`。

4. 清理 Git 缓存与锁定文件
某些情况下本地索引损坏或文件被杀毒软件锁定会导致操作失败。尝试清理缓存并重置状态。
操作：运行 `git rm `--cached` -r .` 后执行 `git reset`，注意备份数据。

执行以下检查确认问题已解决：

普通合并冲突返回退出码 1，表示代码内容不一致但 Git 运行正常；退出码 128 表示 Git 程序本身执行失败，通常因配置或权限问题导致。

打开控制面板的"凭据管理器"，在"Windows 凭据"中找到对应 Git 仓库地址，点击编辑或移除，下次操作时会重新提示输入。

检查 TortoiseGit 设置中是否启用了"Use portable Git"，确认路径合法性，或尝试在 Git Bash 中复现命令查看完整错误输出。