如何在Git中合并多版本docx/pdf文件并保留提交历史？

嘿，这个场景我之前帮团队处理过，完全能搞定！核心思路是把分散的版本文件重新映射成同一个文件的历史提交，同时保留原来的提交时间、作者信息和变更内容。下面是一步步的操作指南：

第一步：先做仓库备份！ #

绝对要先备份，避免操作失误丢数据：

git clone <你的仓库地址> backup-repo

把备份仓库存到安全的地方，万一操作出问题可以随时恢复。

第二步：理清版本顺序 #

先搞清楚所有分散的文档版本的提交顺序，比如report_v1.pdf、report_v2.pdf哪个先提交。用这个命令查看所有PDF/DOCX文件的提交历史：

git log --pretty=format:"%h %ad %an %s" --date=iso -- *.pdf *.docx

输出会显示每个文件的提交哈希、时间、作者和提交信息，你可以把这些版本按时间从早到晚排好序，比如：

• 最早版本：report_v1.pdf（提交哈希：a1b2c3）
• 第二个版本：report_v2.pdf（提交哈希：d4e5f6）
• 最新版本：report_v3.pdf（提交哈希：g7h8i9）

第三步：交互式Rebase修改历史 #

我们用git rebase -i来逐个修改那些新增版本文件的提交，把它们改成修改同一个目标文件的提交：

1. 找到第一个版本文件提交的父提交（也就是在添加report_v1.pdf之前的那个提交），假设它的哈希是xyz123，然后执行：

git rebase -i xyz123

如果第一个版本就是仓库的初始提交，就用git rebase -i --root。

2. 这时会弹出一个编辑器，里面列出了从父提交之后的所有提交。找到每个新增版本文件的那一行，把开头的pick改成edit（比如对应添加report_v1.pdf、report_v2.pdf的提交都改成edit），然后保存退出。

3. 接下来Git会逐个进入这些提交的编辑模式：

   • 处理第一个版本（v1）：
     这个提交是添加report_v1.pdf，我们把它重命名成最终的目标文件名（比如report.pdf）：

     git mv report_v1.pdf report.pdf
     git add report.pdf
     

     然后修改这个提交，保留原来的时间和信息：

     git commit --amend --no-edit
     

     接着继续处理下一个提交：

     git rebase --continue
     

   • 处理后续版本（v2、v3...）：
     进入对应的提交后，先删除当前新增的版本文件（比如report_v2.pdf），然后把它替换成目标文件：

     rm report_v2.pdf
     # 如果你本地已经有report_v2.pdf的内容，直接覆盖report.pdf
     # 或者从提交里提取文件：git show HEAD:report_v2.pdf > report.pdf
     git add report.pdf
     

     然后同样修改提交，保留原时间：

     git commit --amend --no-edit
     

     继续执行git rebase --continue，直到所有版本都处理完。

第四步：验证修改结果 #

处理完所有提交后，查看目标文件的历史：

git log --oneline -- report.pdf

你会看到每个提交都是对report.pdf的修改，而且提交时间还是原来的时间戳，完全保留了历史！

第五步：同步团队仓库 #

因为你修改了Git历史，团队成员需要重新同步仓库：

1. 让所有人先备份本地未提交的修改（非常重要！）
2. 执行强制推送（注意：只有确定没人在这段历史上做新开发时才用，否则会丢代码）：

git push origin main --force

3. 团队成员拉取最新版本：

git fetch origin
git reset --hard origin/main

后续规范 #

为了避免再出现这种情况，和团队约定：

• 修改PDF/DOCX时，直接覆盖原文件，不要新增带版本号的文件
• 提交时用清晰的信息，比如update report.pdf: fix typos in chapter 2
• 如果需要查看二进制文件的变更，可以用第三方工具（比如针对DOCX的git diff --word-diff，或者PDF对比工具）辅助

内容的提问来源于stack exchange，提问作者user9480631