问题排查方法

在Git使用过程中，遇到问题是常态。从代码冲突到分支管理异常，从提交历史混乱到远程仓库同步失败，高效的问题排查能力直接影响开发效率。以下是针对常见Git问题的系统性排查方法，结合具体场景和操作示例展开说明。

本地仓库基础问题排查

工作区文件状态异常 当git status显示大量未跟踪或修改文件时：

# 确认忽略规则是否生效
git check-ignore -v path/to/file

# 清理未被跟踪的文件（危险操作）
git clean -nfd  # 先预览
git clean -fd   # 实际执行

提交历史异常 使用git log配合以下参数精确定位问题：

# 显示图形化分支拓扑
git log --graph --oneline --all

# 查找包含特定字符串的提交
git log -S "missing_function()" --patch

分支与合并冲突处理

分支切换失败 当遇到error: Your local changes to the following files would be overwritten by checkout时：

# 方案1：暂存当前修改
git stash
git checkout target-branch
git stash pop

# 方案2：创建临时分支
git checkout -b temp-branch

合并冲突解决流程

1. 使用git status定位冲突文件
2. 在编辑器中解决冲突标记（<<<<<<<, =======, >>>>>>>）
3. 对每个解决后的文件执行：

git add resolved-file.js

4. 完成合并：

git commit  # 不要修改自动生成的提交信息

远程仓库同步问题

推送被拒绝 当git push返回rejected - non-fast-forward错误时：

# 先拉取远程变更（会产生合并提交）
git pull origin branch-name

# 或使用变基方式（推荐）
git pull --rebase origin branch-name
git push

认证失败处理 SSH方式连接失败时检查：

# 测试SSH连接
ssh -T git@github.com

# 检查远程URL类型
git remote -v
# 必要时切换URL类型
git remote set-url origin git@github.com:user/repo.git

高级问题诊断工具

二分法定位错误提交

git bisect start
git bisect bad          # 标记当前为错误状态
git bisect good v1.0    # 标记已知正常版本
# 根据测试结果继续标记good/bad
git bisect reset        # 结束后重置

重构历史记录 修改最近一次提交：

git commit --amend -m "新的提交信息"

交互式变基（修改多个提交）：

git rebase -i HEAD~3   # 编辑最近3个提交

仓库损坏修复

文件系统级检查

# 检查仓库完整性
git fsck --full

# 恢复丢失的对象
git cat-file -p 丢失的hash值 > recovered-file.txt

重置仓库状态 当.git目录出现问题时：

# 从远程重新克隆（最后手段）
git clone --mirror git@github.com:user/repo.git temp-clone
cd original-repo
git remote update
git reset --hard origin/main

性能问题优化

清理历史大文件 使用BFG工具或原生命令：

# 查找前10大文件
git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -n | tail -10

# 重写历史（彻底删除大文件）
git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch path/to/large-file" \
  --prune-empty --tag-name-filter cat -- --all

仓库压缩

git gc --aggressive --prune=now
git repack -a -d --depth=250 --window=250

钩子脚本调试

排查pre-commit失败 临时绕过钩子：

git commit --no-verify -m "紧急提交"

检查钩子执行环境：

# 在钩子脚本开头添加
env > /tmp/git-hook-env.log
echo "$@" >> /tmp/git-hook-args.log

跨平台兼容问题

换行符问题

# 统一换行符处理
git config --global core.autocrlf input  # Linux/Mac
git config --global core.autocrlf true   # Windows

# 修复现有仓库
git rm --cached -r .
git reset --hard

文件大小写问题

# 重命名文件后需要清除缓存
git mv File.js file.js  # 实际是两条命令的组合
git config core.ignorecase false