Git 重写历史学习文档
目录
基础概念
常用命令详解
实战场景
安全注意事项
最佳实践
故障排除
基础概念
什么是重写历史？
Git重写历史是指修改已有的commit记录，包括：
修改commit信息
合并多个commit（squash）
拆分commit
删除commit
重新排序commit
为什么需要重写历史？
保持历史清洁：合并相关的小commit
修正错误：修改错误的commit信息或内容
符合规范：统一commit格式和风格
便于代码审查：逻辑清晰的commit历史
常用命令详解
- git rebase -i（交互式变基）
基本语法
git rebase -i
git rebase -i HEAD~n # 重写最近n个commit
1. 添加正确的远程仓库（请替换为你的实际仓库名）
git remote add origin https://github.com/hanserfans/你的仓库名.git
2. 验证远程配置
git remote -v
3. 推送代码到 GitHub
git push -u origin main
交互式编辑器选项
pick # 保持commit不变
reword # 修改commit信息
edit # 修改commit内容
squash # 合并到前一个commit
fixup # 合并到前一个commit，丢弃commit信息
drop # 删除commit
实例：合并最近3个commit
1. 启动交互式rebase
git rebase -i HEAD~3
2. 编辑器中会显示：
pick abc1234 第一个commit
pick def5678 第二个commit
pick ghi9012 第三个commit
3. 修改为：
pick abc1234 第一个commit
squash def5678 第二个commit
squash ghi9012 第三个commit
4. 保存退出，然后编辑合并后的commit信息
- git reset（重置）
三种模式
git reset --soft HEAD~n # 保留修改在暂存区
git reset --mixed HEAD~n # 保留修改在工作区（默认）
git reset --hard HEAD~n # 完全删除修改（危险！）
实例：重写最近的commit
方法1：使用soft reset + 重新commit
git reset --soft HEAD~2
git commit -m "合并后的新commit信息"
方法2：修改最后一个commit
git commit --amend -m "修改后的commit信息"
- git cherry-pick（挑选commit）
基本用法
git cherry-pick # 挑选单个commit
git cherry-pick # 挑选多个commit
git cherry-pick .. # 挑选范围
实例：重新组织commit
1. 创建新分支
git checkout -b feature-reorganized
2. 挑选需要的commit
git cherry-pick abc1234
git cherry-pick def5678
3. 删除原分支，重命名新分支
git branch -D feature-old
git branch -m feature-reorganized feature-old
- git filter-branch（批量重写）
修改作者信息
git filter-branch --env-filter '
if [ "$GIT_COMMITTER_EMAIL" = "old@email.com" ]
then
export GIT_COMMITTER_NAME="New Name"
export GIT_COMMITTER_EMAIL="new@email.com"
export GIT_AUTHOR_NAME="New Name"
export GIT_AUTHOR_EMAIL="new@email.com"
fi
' --tag-name-filter cat -- --branches --tags
删除敏感文件
git filter-branch --force --index-filter
'git rm --cached --ignore-unmatch sensitive-file.txt'
--prune-empty --tag-name-filter cat -- --all
实战场景
场景1：合并多个小commit
问题：开发过程中产生了多个小的commit，需要合并为一个逻辑完整的commit。
解决方案：
查看最近的commit
git log --oneline -5
交互式rebase合并最近3个commit
git rebase -i HEAD~3
或者使用reset方法
git reset --soft HEAD~3
git commit -m "feat: 实现完整功能"
场景2：修改commit信息
问题：commit信息写错了，需要修改。
解决方案：
修改最后一个commit信息
git commit --amend -m "正确的commit信息"
修改历史commit信息
git rebase -i HEAD~n
将需要修改的commit前的pick改为reword
场景3：拆分一个大commit
问题：一个commit包含了太多不相关的修改，需要拆分。
解决方案：
1. 交互式rebase
git rebase -i HEAD~1
2. 将pick改为edit
edit abc1234 需要拆分的commit
3. 重置到上一个commit
git reset HEAD~1
4. 分别添加和提交
git add file1.java
git commit -m "feat: 添加功能A"
git add file2.java
git commit -m "fix: 修复bug B"
5. 继续rebase
git rebase --continue
场景4：删除敏感信息
问题：不小心提交了包含密码或密钥的文件。
解决方案：
方法1：如果是最近的commit
git reset --hard HEAD~1
方法2：使用filter-branch删除文件
git filter-branch --force --index-filter
'git rm --cached --ignore-unmatch config/secrets.yml'
--prune-empty --tag-name-filter cat -- --all
方法3：使用BFG Repo-Cleaner（推荐）
java -jar bfg.jar --delete-files secrets.yml
git reflog expire --expire=now --all && git gc --prune=now --aggressive
安全注意事项
⚠️ 重要警告
永远不要重写已推送到公共仓库的历史
会导致其他开发者的历史混乱
可能造成代码丢失
重写历史前先备份
git branch backup-branch
git tag backup-tag
团队协作中的规则
只重写本地分支的历史
重写后使用 --force-with-lease 推送
提前通知团队成员
安全的重写流程
1. 创建备份
git branch backup-$(date +%Y%m%d-%H%M%S)
2. 执行重写操作
git rebase -i HEAD~3
3. 验证结果
git log --oneline -10
git diff backup-branch
4. 安全推送（如果需要）
git push --force-with-lease origin feature-branch
最佳实践
- Commit信息规范
使用约定式提交（Conventional Commits）：
optional scope\]: \[optional body
optional footer(s)
示例：
feat(auth): 添加用户登录功能
fix(api): 修复数据查询bug
docs: 更新API文档
refactor: 重构用户服务代码
- 重写时机
适合重写的情况：
本地开发分支
功能分支合并前
修复明显的错误
不适合重写的情况：
已合并到主分支
多人协作的分支
已发布的版本
- 工具推荐
设置更好的编辑器
git config --global core.editor "code --wait"
设置别名简化操作
git config --global alias.squash "rebase -i"
git config --global alias.amend "commit --amend"
git config --global alias.undo "reset --soft HEAD~1"
美化log显示
git config --global alias.lg "log --oneline --graph --decorate"
故障排除
问题1：rebase冲突
现象：rebase过程中出现冲突
Auto-merging file.txt
CONFLICT (content): Merge conflict in file.txt
解决方案：
1. 手动解决冲突
编辑冲突文件，删除冲突标记
2. 添加解决后的文件
git add file.txt
3. 继续rebase
git rebase --continue
或者放弃rebase
git rebase --abort
问题2：丢失commit
现象：重写历史后找不到某个commit
解决方案：
1. 查看reflog
git reflog
2. 找到丢失的commit hash
3. 恢复commit
git cherry-pick
或者重置到之前的状态
git reset --hard
问题3：推送被拒绝
现象：
! [rejected] feature -> feature (non-fast-forward)
解决方案：
使用force-with-lease（更安全）
git push --force-with-lease origin feature
或者普通force push（谨慎使用）
git push --force origin feature
实用脚本
自动squash脚本
#!/bin/bash
squash-commits.sh
用法: ./squash-commits.sh 3 "新的commit信息"
if [ $# -ne 2 ]; then
echo "用法: $0 <commit数量> <新commit信息>"
exit 1
fi
COMMIT_COUNT=$1
COMMIT_MESSAGE=$2
创建备份
git branch backup-$(date +%Y%m%d-%H%M%S)
执行squash
git reset --soft HEAD~$COMMIT_COUNT
git commit -m "$COMMIT_MESSAGE"
echo "已将最近 COMMIT_COUNT 个commit合并为: COMMIT_MESSAGE"
清理历史脚本
#!/bin/bash
clean-history.sh
清理包含敏感信息的文件
if [ $# -ne 1 ]; then
echo "用法: $0 <敏感文件路径>"
exit 1
fi
SENSITIVE_FILE=$1
echo "警告：即将从历史中删除 $SENSITIVE_FILE"
read -p "确认继续？(y/N): " confirm
if [ "confirm" = "y" \] \|\| \[ "confirm" = "Y" ]; then
git filter-branch --force --index-filter
"git rm --cached --ignore-unmatch $SENSITIVE_FILE"
--prune-empty --tag-name-filter cat -- --all
echo "文件已从历史中删除，请执行："
echo "git reflog expire --expire=now --all"
echo "git gc --prune=now --aggressive"
echo "git push --force-with-lease --all"
fi
学习资源
官方文档
Git Pro Book - 重写历史
Git Reference - rebase
在线练习
Learn Git Branching
Git Immersion
推荐工具
GitKraken：可视化Git操作
SourceTree：图形界面Git客户端
BFG Repo-Cleaner：清理大文件和敏感信息
总结
Git重写历史是一个强大但需要谨慎使用的功能。掌握这些技能可以帮助你：
✅ 保持代码历史清洁
✅ 提高团队协作效率
✅ 符合项目规范要求
✅ 便于代码审查和维护
记住：安全第一，备份为王！
最后更新：2025年10月
作者：开发团队