Git 协作:分支管理与多人协作实战
Git 协作:分支管理与多人协作实战
一个人写代码,Git 只是一个备份工具;几个人一起写代码,Git 才真正变成协作工具。很多团队的混乱不是代码写得差,而是分支用得乱:有人直接在 main 上改,有人一个分支用三个月,有人合并时冲突满天飞。本文讲一套小团队就能直接用的分支协作方法,不求花哨,只求不出乱子。
先定一条主线:main 永远可发布
协作的第一条规矩是 main 分支永远保持可发布状态。所有新功能、修 bug 都从 main 切出分支去做,做完再合回来。main 上不直接提交代码,这条规则一旦松动,线上出问题时就没人敢说“回滚到上一个稳定版本”。
分支命名也值得统一一下。功能分支用 feature/xxx,修 bug 用 fix/xxx,紧急线上修复用 hotfix/xxx。名字本身就是文档,新人一眼就能看出这个分支在干什么。分支名里不要出现中文和空格,避免在某些工具里出问题。
一个功能的完整流程
从 main 切出功能分支开始:
git checkout main
git pull origin main
git checkout -b feature/user-login
开发过程中每天至少提交一次,提交信息写清楚做了什么,而不是“更新”“修改”“fix”。好的提交信息长这样:feat: 增加登录验证码校验;坏的提交信息是:改了一下。将来查问题、回滚代码时,提交信息就是唯一的线索。
功能做完先在本地合并一次 main,把冲突在自己手里解决掉:
git checkout feature/user-login
git merge main
解决完冲突、跑通测试,再推到远端并发起合并请求(Pull Request / Merge Request)。合并请求不是形式主义,它是团队里唯一一次“别人替你看一眼代码”的机会。哪怕只有一个人 review,也比没人看强得多。
合并请求怎么写才有用
合并请求里至少写三件事:这次改了什么、为什么改、怎么验证。贴一张截图或一段测试结果,比写一百字描述都管用。review 的人重点看三点:有没有改到不该改的地方、有没有明显的逻辑错误、有没有漏掉测试。
小步合并是关键。一个合并请求最好只做一件事,改动控制在几百行以内。上千行的合并请求没人愿意认真看,最后只能闭着眼睛点通过,review 就失去了意义。功能太大就拆成几个小合并请求,依次合入。
冲突不可怕,怕的是不敢处理
冲突的本质是两个人改了同一处代码,Git 不知道该听谁的。处理冲突没有捷径:打开冲突文件,看清双方的改动,保留正确的部分,删掉冲突标记,然后重新测试再提交。
有两条经验可以少踩坑:第一,功能分支的生命周期越短越好,超过一周没合入的分支,冲突概率会直线上升;第二,每天开始工作前先把 main 的最新代码合进自己的分支,小冲突天天清,比攒成大冲突一次解决轻松得多。
几个救命的常用命令
写错提交信息,还没推送时可以改:git commit --amend。不小心把文件加进暂存区:git restore --staged <文件>。想看看某次提交改了什么:git show <提交号>。不确定自己改了哪些文件:git status 和 git diff 每天看几遍都不多余。
最重要的一条:推送之前先拉取。git pull --rebase 能让你的提交排在最新代码之后,历史记录保持一条直线,比满屏的 merge 提交清爽得多。团队统一用 rebase 还是 merge,选一种坚持下去就行,最怕有人用这个、有人用那个。
协作的本质是习惯
Git 的命令不难,难的是团队养成一致的习惯:main 不直接提交、分支短命、小步合并、提交信息写清楚、冲突当天解决。把这些习惯固定下来,多人协作就从“天天救火”变成了“按流程走”。工具只是把规矩落地的手段,真正的协作,靠的是每个人都遵守同一套约定。
- 点赞
- 收藏
- 关注作者
评论(0)