用 Git 分支管好小组作业:从第一次提交到合并冲突的完整流程
小组作业最怕的不是题目难,而是四个人同时改同一份代码,最后谁也不知道哪个版本是对的。我第一次参加小组编程作业时就吃过这个亏:有人直接在群里发了一份“最终版.zip”,有人在自己的电脑上又改了一版,交作业前一个小时,全组都在对着三个名字差不多的压缩包发愁。从那以后,我们小组固定用 Git 分支来协作,作业再也没有出现过“版本打架”的情况。这篇文章把这套做法完整讲清楚,照着做就能用。
一、先定规矩,再写代码
动手写代码之前,先花十分钟定三条规矩,这十分钟能省掉后面好几个小时的麻烦。第一,仓库只有一个,由组长创建,其他人用克隆的方式加入,不要每个人各建一个仓库。第二,主分支 main 是“干净的底线”,平时谁也不直接在上面改代码,只接受合并进来的、已经检查过的内容。第三,每个人领任务后先建自己的分支,分支名要能看出人和任务,例如 feature/zhangsan-login、feature/lisi-report,分支名本身就是一份任务清单。
另外要约定提交信息的写法。提交信息不是写给机器看的,是写给第二天来接手的队友看的。好的提交信息一句话就能说清改了什么、为什么改,例如“登录页增加手机号格式校验,避免空值提交”。不好的提交信息只有“改了一下”“修 bug”“再试一次”,过两天连自己都看不懂。组内可以约定:每次提交只做一件事,改完一个小功能就提交一次,不要攒到最后一次性提交几百行。
二、第一次提交:从建仓到推送
组长先在本地创建一个项目文件夹,完成下面这几步。第一次操作时建议逐行敲命令,不要复制粘贴整段,敲一遍就记住了:
git init
git add .
git commit -m "初始化项目:搭建作业目录结构"
git branch -M main
git remote add origin 仓库地址
git push -u origin main
这几行命令分别做了五件事:初始化仓库、把文件加入暂存区、做第一次提交、把当前分支命名为 main、把本地仓库和远程仓库关联起来并推送上去。推送成功后,其他组员不需要再执行 git init,只需要把仓库克隆到自己的电脑上:
git clone 仓库地址
cd 项目文件夹
git status
克隆完成后先运行 git status 看一眼,确认当前在 main 分支、工作区是干净的,再开始自己的任务。这是一个好习惯:开始工作前先确认状态,结束工作前也确认一次,能拦住很多低级错误。
三、每人一个分支,互不干扰
每个组员开始任务前,先从最新的 main 分支切出自己的分支:
git checkout main
git pull
git checkout -b feature/zhangsan-login
先切回 main 并拉取最新代码,是为了保证自己的分支站在最新的起点上。如果跳过这一步,分支可能是从三天前的旧代码切出来的,后面合并时冲突会多很多。在自己的分支上随便改、随便试,改坏了也不会影响别人,这是分支协作最大的好处。每天结束前,把当天的进度提交并推送到远程:
git add .
git commit -m "登录页增加手机号格式校验"
git push -u origin feature/zhangsan-login
第一次推送分支时要加上 -u 参数,建立本地分支和远程分支的关联,之后再推送只需要写 git push 就可以了。提交之前建议先用 git status 和 git diff 看一眼改了哪些文件,确认没有把调试用的临时文件、同学的私人文件一起提交上去。
四、每天同步一次,别攒到最后
小组协作最常见的翻车原因是“各自闷头写一周,最后一天才合并”。正确的做法是每天至少同步一次:先把 main 的最新代码合并到自己的分支,解决小冲突,继续写;任务完成后再把自己的分支合并回 main。同步自己分支的命令是:
git checkout feature/zhangsan-login
git pull origin main
如果这一步提示有冲突,不要慌,冲突是分支协作的正常现象,不是做错了什么。Git 会在冲突的文件里用标记把两边的改动都标出来,你要做的就是打开文件,决定保留哪一边,或者把两边的合理改动合在一起,删掉标记行,然后重新提交:
git add 冲突的文件名
git commit -m "合并 main 最新代码,解决登录页冲突"
任务完成、自己测试通过后,再发起合并。可以在仓库页面上发起合并请求,让另一位组员看一眼代码再点合并,多一双眼睛,就少一个低级错误。合并后,组长或作者本人要记得删除已经合并的旧分支,避免仓库里堆满用完的分支。
五、合并冲突时,手不要抖
第一次遇到冲突标记,很多人第一反应是把整个文件删掉重写,这恰恰是最危险的做法。冲突标记长这样:
<<<<<<< HEAD
这是 main 分支上的版本
=======
这是你分支上的版本
>>>>>>> feature/zhangsan-login
处理方法是逐个文件、逐段解决:先读懂两边各改了什么,再决定保留哪一段;如果两边的改动都合理,就把它们拼成一段通顺的代码;最后删掉所有的标记行,保存文件,重新提交。解决完冲突一定要重新运行一次程序,确认功能还能正常工作,再推送。千万不要只解决标记、不做测试就合并,那样等于把问题藏进了 main 分支。
还有一个新手常犯的错误:冲突还没解决完,就急着执行 git add . 把所有文件都加进去。正确的做法是先解决冲突,再有针对性地添加已经解决的文件。如果实在不确定某次合并改坏了什么,可以用 git log 看提交历史,用 git diff 对比改动,定位问题后再动手。
六、小组作业的常见翻车现场
第一,直接在 main 分支上改代码。改到一半发现思路不对,想回退都不知道从哪里退。解决办法是立刻停下,先把改动提交到自己的新分支,再切回 main。第二,提交信息写得太随意。第三,把账号密码、密钥文件提交进仓库。密码一旦推送到远程仓库,就要当作已经泄露来处理:改密码、换密钥,只删除文件是不够的,因为提交历史里还留着记录。第四,忘记写 .gitignore,把编译产物、依赖包目录、编辑器配置文件一起提交上去,仓库很快就会变得臃肿。项目开始时就建好 .gitignore,把不需要进仓库的东西挡在门外。
七、能直接抄的检查清单
每次提交前对照这份清单过一遍:当前分支是不是自己的任务分支;git status 里有没有不该提交的文件;提交信息能不能让队友看懂;改完的代码自己运行过没有;推送之后有没有请队友看一眼。每天结束前再过一遍:今天的进度推送了没有;明天要做的事有没有写在分支名或任务清单里。
Git 分支协作的核心其实只有一句话:每个人在自己的分支上安心写代码,main 分支永远保持可用。规矩定好、每天同步、冲突逐段解决,小组作业就从“互相覆盖”变成了“互相加分”。如果你现在的小组还在用压缩包传代码,不妨从下一次作业开始试试这套流程,第一次可能慢一点,但第二次开始,你会发现省下来的时间远比花掉的多。
- 点赞
- 收藏
- 关注作者
评论(0)