常见错误与解决方案

Git作为分布式版本控制系统，广泛用于代码管理，但在使用过程中容易出现各种问题。以下是常见错误场景及其解决方案。

提交时忽略文件

.gitignore配置错误导致敏感文件或临时文件被意外提交。例如：

# 错误现象
$ git add .
$ git commit -m "add config"
# 发现node_modules/也被提交了

解决方案分三步：

1. 检查现有.gitignore文件是否包含正确规则：
   gitignore 复制代码

   # 正确示例
   node_modules/
   *.log
   .env

2. 清除已跟踪但应忽略的文件：
   bash 复制代码

   git rm -r --cached node_modules
   git commit -m "remove ignored files"

3. 验证忽略效果：
   bash 复制代码

   git status --ignored

冲突合并失败

多人协作时经常遇到合并冲突，典型报错：

CONFLICT (content): Merge conflict in src/app.js
Automatic merge failed; fix conflicts and then commit the result.

解决步骤：

1. 使用git status定位冲突文件
2. 手动编辑文件解决冲突标记：
   javascript 复制代码

   // 冲突示例
   <<<<<<< HEAD
   const apiUrl = 'https://prod.example.com';
   =======
   const apiUrl = 'https://test.example.com';
   >>>>>>> feature/new-api

3. 保留需要的版本后重新提交：
   bash 复制代码

   git add src/app.js
   git commit -m "resolve api url conflict"

误删分支恢复

执行git branch -D feature/login后需要恢复分支：

# 查看最近引用记录
git reflog
# 找到删除前的commit hash
git checkout -b feature/login a1b2c3d

提交信息写错

需要修改最近一次提交信息：

git commit --amend -m "新的提交信息"
# 强制推送到远程（仅限未与他人共享的分支）
git push origin feature/login --force

错误重置代码

使用git reset --hard后丢失未提交代码的恢复方法：

1. 查找丢失的commit：
   bash 复制代码

   git fsck --lost-found

2. 检查生成的.git/lost-found目录
3. 使用git show验证内容后恢复

大文件提交错误

尝试提交大文件时出现remote: error: File is 123.00 MB错误：

1. 从历史记录中清除大文件：
   bash 复制代码

   git filter-branch --tree-filter 'rm -f assets/video.mp4' HEAD

2. 配置正确的.gitattributes：
   gitignore 复制代码

   *.mp4 filter=lfs diff=lfs merge=lfs -text

3. 使用git-lfs管理大文件

分支污染

将多个特性开发混在同一分支时：

# 当前在dev分支但有未完成的feature A和B
git stash save "feature A"
git checkout -b feature/B
# 完成B后
git checkout dev
git stash pop

凭证存储问题

频繁要求输入密码时配置凭证存储：

git config --global credential.helper store
# 下次输入后会被保存

中文路径显示异常

解决git status显示中文路径为八进制编码：

git config --global core.quotepath false

子模块更新失败

更新包含子模块的项目时：

git submodule update --init --recursive
# 或克隆时直接包含子模块
git clone --recurse-submodules <repo-url>

行尾符问题

跨平台开发时出现CRLF/LF警告：

# 统一转换为LF
git config --global core.autocrlf input
# Windows系统使用
git config --global core.autocrlf true

历史记录重写风险

交互式变基时可能破坏协作分支：

# 安全操作步骤
git checkout feature
git rebase -i main
# 解决冲突后强制推送
git push origin feature --force-with-lease

标签管理错误

误删标签后的恢复方法：

# 本地恢复
git tag v1.0.1 a1b2c3d
# 推送到远程
git push origin v1.0.1

工作目录清理

需要彻底清除未跟踪文件时：

git clean -fd
# 预览将要删除的文件
git clean -fdn

二分法调试

使用git bisect定位问题提交：

git bisect start
git bisect bad HEAD
git bisect good v1.0
# 测试后标记当前提交
git bisect good/bad
# 结束后重置
git bisect reset

补丁应用错误

应用.patch文件时路径问题：

git apply --check fix.patch
# 忽略路径层级
git apply -p2 fix.patch

引用日志过期

默认30天后git reflog记录会被清除，修改保留时间：

git config --global gc.reflogExpire 90.days

稀疏检出

只克隆部分目录：

git clone --filter=blob:none --no-checkout <repo>
cd repo
git sparse-checkout init --cone
git sparse-checkout set src/docs
git checkout main