fix、fix again、update 2、打死不再改版。
课程设计答辩结束的那天晚上,我在宿舍整理这学期几个人合写的仓库,顺着提交历史往回翻,满屏都是答辩前夜大家慌里慌张敲下的这些字。看着看着我自己先笑了——最后那条“打死不再改版”,是我提交的,后面紧跟着两条它的修复。
Git 用得越久,我越觉得它最值钱的本事,不在于把几个人的代码硬凑到一起,而在于让每一次改动过后还能被解释、被比较、被安安稳稳地恢复。要是写代码时眼里只有“最后能不能顺顺当当合进去”,起点和终点之间那些思考的脉络,很快就会在匆忙赶工里磨损殆尽。
一次提交,一件事
为了不让几个月后的自己翻看提交历史时对着屏幕发呆,我越来越偏爱围绕“一件能用一句话说得清的变化”来切小提交。修掉一个空指针报错,给旧函数补一条单元测试,订正一份过期的启动说明——三件事各提交各的,比把它们胡乱揉进同一个大包里要清爽得多。
这就好比搬家打包行李。把冬天的厚外套、充电线和零食全塞进同一个纸箱,封箱那一刻固然省事,可过两个礼拜急着找某根转接线时,就只能蹲在地上把整箱翻个底朝天。敲下提交信息时,老老实实写清动作的动词与改动范围,再配上一跑就通的测试和一两句简短说明,哪怕隔了大半年顺着日志往回摸,也能一眼认出自己当初为什么要动这一刀。
分支是用来安心折腾的
分支的用处,本就是让人能放心折腾还没写完的功能,绝不是为了在图形界面里画出一棵枝繁叶茂的铁路图来显得仓库有多“专业”。短期的功能分支尽量贴着主线走,使命一旦完成就痛痛快快合并、删掉。那些迟迟不肯合入主干、又一直拖着不发布的长期分支,攒得越久,越容易在暗处把代码冲突与环境依赖养成一颗没人敢碰的哑炮。给分支起个好懂的名字固然能帮人一眼认出主题,但真正让人省心的,永远是把每次改动的步子迈得小一点、勤快一点。
合并之前看什么
代码检视时,我更在意代码跑起来之后的脾气,缩进和命名倒是次要的:新加进来的接口有没有把异常情况和报错提示想周全?涉及数据库表结构的变更脚本,在流水线里万一被重复执行会不会当场炸锅?配置文件的改动里,有没有一时疏忽把本地调试用的密钥带了进来?还有最朴素的一条——这版改动合进去之后,原来的老功能还能不能照常跑起来?
自动化测试确实能替我们拦下不少显而易见的粗心,但交互和逻辑上那些微妙的漏洞,终究没法代替活生生的人去琢磨。就算是我一个人独自维护的私人小玩具,这套检视习惯同样可以用很轻量的方式跑起来:每次提交前逼自己只聚焦一件事,顺着报错分支通读一遍 git diff,再开个干净的终端窗口跑一次最小验证命令。这往往比盲目往上堆砌一摞复杂的检查插件管用得多。
给回滚留条路
检查做得再细致,服务跑在线上也总有遇到意外、需要往后退一步的时候。在我的日常习惯里,总会特意给回滚留出一点从容喘息的余地。
常见的退路通常就两条:要么在代码层面撤销某次改动,要么干脆把线上部署的指针直接拨回上一份稳妥的构建产物。走前一条路会产生一次新的提交,在和队友共用的分支上,老老实实用 git revert 留下明明白白的撤销轨迹,远比强行 push -f 改写历史、害得队友下午一拉代码满屏冲突要厚道得多;走后一条路,则要求平时就留好旧版本的构建包,并提前想好新老数据的兼容方案。
在真正按下回退键之前,先花几分钟确认旧构建包依然能够顺利启动、数据库脚本彼此兼容,再决定究竟是回退代码还是切换部署指针。毕竟回退的本意是在故障发生时稳住阵脚,让我们能踏踏实实喝口水、看清问题出在哪儿,从来不代表向失败低头。
main 不等于上线
代码一旦走出本地编辑器、与远端的部署脚本接上了头,打标签和写发布记录就不再是可有可无的形式感。每一个正式版本号背后,都应当清清楚楚地对应到当时的源码快照、构建产物与配置变更。唯有如此,真等线上冒出怪毛病时,我们手里才握有还原现场的钥匙。
我一直很忌讳把“代码推到 main 分支”直接当成“功能已经上线”。在代码合并与朋友真正能在浏览器里点开之间,还隔着构建、部署和线上验收。为了不在这个路口踩空,我现在发布前会顺手核对几件小事:提交记录清不清楚?关键测试跑没跑?数据库脚本经不经得起重复执行?眼前这个构建产物究竟对应哪一个提交哈希?备用的旧版本还在不在原处?
寒假前的校园已经空了大半,楼道里拖行李箱的声音一阵一阵的。
Git 的规矩定得再细,说到底是在替人那点不怎么牢靠的记忆兜底。把单次改动的步子迈得小一点,来龙去脉记清楚一点,随时能退回去的小路铺得平一点。等哪天重新打开这个项目,我希望自己还能笑着认出当初写下这行代码的自己。
那天晚上睡前,我给仓库补了一份 CONTRIBUTING.md,第一条写的是:提交信息里不许出现“打死不再改”。