如何在GitHub中合理分离前后端？团队协作Git提交异常求助

问题根源 #

你遇到的提交历史被篡改、无关后端文件被同步的问题，核心原因是本地分支与远程分支的提交历史不一致，拉取时错误的合并方式导致历史被重写，进而把无关提交同步到远程仓库。

紧急处理步骤 #

• 立刻告知团队成员暂停推送操作，防止问题范围扩大
• 复制整个本地项目文件夹到其他位置做备份，避免操作失误丢失代码

修复本地分支历史 #

方式一：清理本地污染的提交历史 #

1. 获取远程仓库最新的所有分支状态（不合并代码）：

   git fetch origin
   

2. 对比本地分支与远程主分支的提交差异（假设主分支为main）：

   git log --oneline origin/main..main
   

3. 执行交互式变基，移除篡改后端历史的提交：

   git rebase -i origin/main
   

   打开编辑器后，将所有涉及修改后端文件的提交行前的pick改为drop，保存退出。若变基时出现冲突，仅保留远程后端文件的版本，解决前端相关冲突后执行：

   git add .
   git rebase --continue
   

方式二：重置本地分支后重新提交（适用于本地历史完全混乱的情况） #

1. 暂存本地未提交的前端修改：

   git stash
   

2. 重置本地分支到远程仓库的最新状态：

   git reset --hard origin/main
   

3. 恢复暂存的前端代码：

   git stash pop
   

4. 仅添加前端文件夹的修改，避免误操作：

   git add frontend/
   

5. 提交前端代码：

   git commit -m "你的前端提交描述"
   

正确推送代码 #

• 推送前确认仅修改了前端文件：执行git status检查变更列表，确保只有frontend/下的文件有改动
• 若推送时提示历史不一致，先和团队确认远程仓库没有新提交，再谨慎执行强制推送（会覆盖远程历史，需团队共识）：

  git push -f origin main
  

后续操作规范 #

• 提交代码时仅添加前端相关文件：用git add frontend/替代git add .，避免误包含后端文件
• 拉取代码时使用变基模式，保持提交历史线性：

  git pull --rebase
  

• 定期执行git fetch查看远程仓库状态，避免本地分支落后过多导致冲突

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