git协作开发指导

🔧 【用途定位】

• 解决小团队 Vibe Coding 协作中的代码版本控制、分支合并与冲突处理问题。
• 核心工具：Git / GitHub。关键名词：分支策略、PR（Pull Request）、Commit 规范、Rebase、Revert/Reflog。

📋 【核心方法】

1. 分支规则：main 永远保持可运行状态，禁止直接 push；所有功能或修复均在独立分支完成。
2. 日常流程：git pull 同步最新代码 → git switch -c feature/xxx 创建分支 → 开发中频繁 git add . 和 git commit → git push origin feature/xxx 推送 → GitHub 创建 PR → 他人 Review 后合并并删除分支。
3. Commit 格式：feat（新功能）/ fix（修 bug）/ docs（改文档）。
4. 冲突处理：git fetch 拉取最新 → git rebase origin/main 将改动变基到最新 main → 手动修改冲突文件 → git add . → git rebase --continue。
5. 紧急救火：git revert HEAD 安全撤销最近一次提交（不影响他人）；git reflog 查找并恢复误删的提交记录。

⚠️ 【避坑指南】

• 严禁在 main 分支直接开发或提交，防止污染主干导致团队协作崩溃。
• rebase 操作仅适用于个人私有分支，已推送到远程且被他人拉取的分支切勿使用，以免引发历史重写冲突。
• git revert 会生成新的反向提交，适合已公开的远程分支；若仅本地未推送，可使用 git reset --soft/--hard 更彻底地回退。
• 保持 Commit 粒度小而精，每次只提交一个明确的功能点或修复，便于后续追溯与 PR 审查。