git重写历史

Git 重写历史学习文档

目录

基础概念

常用命令详解

实战场景

安全注意事项

最佳实践

故障排除

基础概念

什么是重写历史？

Git重写历史是指修改已有的commit记录，包括：

修改commit信息

合并多个commit（squash）

拆分commit

删除commit

重新排序commit

为什么需要重写历史？

保持历史清洁：合并相关的小commit

修正错误：修改错误的commit信息或内容

符合规范：统一commit格式和风格

便于代码审查：逻辑清晰的commit历史

常用命令详解

1. 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信息

1. 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信息"

1. 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

1. git filter-branch（批量重写）

修改作者信息

git filter-branch --env-filter '

if [ "$GIT_COMMITTER_EMAIL" = "[e-mail]" ]

then

export GIT_COMMITTER_NAME="New Name"

export GIT_COMMITTER_EMAIL="[e-mail]"

export GIT_AUTHOR_NAME="New Name"

export GIT_AUTHOR_EMAIL="[e-mail]"

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

最佳实践

1. Commit信息规范

使用约定式提交（Conventional Commits）：

[optional scope]: 

[optional body]

[optional footer(s)]

示例：

feat(auth): 添加用户登录功能

fix(api): 修复数据查询bug

docs: 更新API文档

refactor: 重构用户服务代码

1. 重写时机

适合重写的情况：

本地开发分支

功能分支合并前

修复明显的错误

不适合重写的情况：

已合并到主分支

多人协作的分支

已发布的版本

1. 工具推荐

设置更好的编辑器

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月

作者：开发团队