Git 团队开发全流程实战指南

永远不要直接 checkout origin/feature/driver 做开发（会 detached HEAD）

✅ 正确做法：

git switch -c feature/kaifa origin/feature/driver

（旧写法等价）

git checkout -b feature/kaifa origin/feature/driver

这一步同时完成：

以公司分支为起点创建你自己的本地分支并立即切换到该分支 本地可写分支：feature/kaifa 基于只读快照：origin/feature/driver

此时结构是：

feature/kaifa（本地 · 可开发） | o───o───o origin/feature/driver（远程 · 只读） | o───o───o 

六、第四步：在本地分支上开发与提交（写代码 → add → commit（最小闭环）

此时你只做一件事：

只在 feature/kaifa 上写代码

6.1 查看改动

git status
git diff

6.2 暂存修改

git add .

6.3 提交到本地分支

git commit -m "feat: 完成 xxx 功能"

⚠️ 一个关键认知：

git commit 只会进入 feature/kaifa（本地） 不会影响 origin/feature/driver。

七、第五步：推送到远程，参与团队协作

首次推送建议使用：

git push -u origin feature/kaifa

-u 作用是：

在远程创建 feature/kaifa 建立本地与远程的跟踪关系

之后你只需要：

git push

八、第六步：开发过程中如何同步公司最新代码（高频场景）

公司同事一直在更新 feature/driver，你需要同步。

推荐安全流程（工程常用）

git switch feature/kaifa
git fetch origin
git merge origin/feature/driver

如果有冲突：

1️⃣ 修改冲突文件 2️⃣ git add 冲突文件 3️⃣ git commit

⚠️ 新人阶段不建议一上来就 rebase

九、开发完成：提交 PR / MR 合并回公司分支（团队标准闭环）

做完功能并 push 后：

远程有 feature/kaifa 公司主开发在 feature/driver

✅ 正规流程是：

1）在 GitLab / GitHub / Gitee 上创建 MR/PR 2）目标分支：feature/driver 3）评审通过后合并 4）你本地再同步一次最新 feature/driver

十、常见错误与易踩坑总结

❌ 在 origin/xxx 上开发 ❌ detached HEAD 状态下长期写代码 ❌ 不区分 fetch / merge / pull ❌ 把'远程分支'当'本地分支'

✅ 正确认知：

• origin/xxx = 只读快照
• 本地分支 = 唯一可开发实体
• 提交必须有分支承载

git clone 只是同步远程状态； 真正的开发，永远从'基于 origin/xxx 创建本地分支'开始。