向开源项目提交PR前的rebase操作咨询：如何将多次commit与同步记录合并为单个commit
看起来你在整理fork的提交历史、拆分分支时遇到了一些小麻烦，我来一步步帮你解决这两个问题：
问题1：把文档提交移到单独分支
先理清楚你的提交时间线：
- 新增测试函数 → 提交A
- 合并上游更新 → 提交B（自动生成的Merge记录）
- 修复bug → 提交C
- 新增文档 → 提交D
- 再次合并上游更新 → 提交E（又一条Merge记录）
你之前的操作没生效，是因为git reset HEAD <sha-of-提交C>默认是--mixed模式，只会重置分支指针和暂存区，不会修改工作区文件。下面是正确的操作步骤：
步骤1：创建文档分支并保留现有修改
先确保当前在master分支，创建doc分支继承所有现有提交（包括文档修改和Merge记录）：
git checkout master git branch doc
步骤2：将master分支回退到修复bug后的状态
用--hard参数彻底重置master的分支指针、暂存区和工作区，完全移除文档修改和后续的Merge记录：
git reset --hard <sha-of-提交C>
执行后，你的本地master目录会回到修复bug后的状态，文档修改会被彻底移除。
步骤3：重新同步上游代码（避免多余Merge commit）
之前用git pull会自动生成Merge记录，这次改用rebase方式拉取，让你的提交直接衔接在上游最新版本之后：
# 若还没添加上游远程仓库，先执行这一步（替换为原项目的仓库地址） git remote add upstream https://github.com/AllStarLink/your-repo-name.git # 用rebase模式拉取上游master的最新代码 git pull --rebase upstream master
步骤4：在doc分支单独保留文档修改
切换到doc分支，同步上游代码的同时保留文档修改：
git checkout doc # 先暂存文档修改，避免rebase时冲突 git stash push -m "temp doc changes" # 同样用rebase同步上游代码 git pull --rebase upstream master # 恢复暂存的文档修改 git stash pop # 重新提交文档修改到doc分支 git add <对应readme文件的路径> git commit -m "Add documentation to readme"
现在doc分支就单独保存了你的文档修改，且和上游代码同步，没有多余的Merge记录。
问题2：将需要的提交合并为单个commit用于PR
现在你的master分支提交链是：上游最新提交 → 提交A'（重写后的测试函数） → 提交C'（重写后的修复bug）。接下来把这些合并成一个提交：
步骤1：启动交互式rebase
指定上游最新提交作为基准，执行：
git rebase -i upstream/master
步骤2：修改提交指令
打开的编辑器会列出你在上游之后的所有提交，类似：
pick abc123 Added test/utility functions to .c and .h files pick def456 Fixed a bug
把第二个提交的pick改成squash（或缩写s），表示将这个提交合并到前一个：
pick abc123 Added test/utility functions to .c and .h files squash def456 Fixed a bug
保存并退出编辑器。
步骤3：编辑合并后的提交信息
接下来会弹出新的编辑器，让你编写合并后的提交信息，整合两个提交的内容即可，比如：
Add test functions and fix core bug - Added test/utility functions to relevant .c and .h files - Resolved a critical bug unrelated to documentation changes
保存退出后，rebase就完成了，此时你的master分支只有一个基于上游最新代码的提交。
步骤4：强制推送到你的fork
因为重写了提交历史，需要用强制推送覆盖GitHub上的fork分支：
git push -f origin master
⚠️ 注意：强制推送前要确保只有你自己在使用这个分支，没有其他协作者基于它开发。
步骤5：提交PR
现在去GitHub你的fork页面，提交PR到原项目的master分支，PR里就只会显示这一个合并后的提交，完全符合项目的要求。
额外小贴士
- 之后同步上游代码时，尽量用
git pull --rebase upstream master，避免生成多余的Merge commit，保持提交历史干净。 - 如果rebase过程中遇到冲突，按提示修改冲突文件，执行
git add <冲突文件>，然后git rebase --continue；若要放弃rebase，执行git rebase --abort。
这样应该就能完美解决你的问题了，祝你PR顺利！
