Git 提交信息的艺术
好的提交信息就像好的注释——它们告诉你「为什么」而不是「做了什么」。代码 diff 已经显示了做了什么,但只有写代码的人知道当时为什么那样选择。
一个常见的误区是把提交信息写成流水账:「修改了样式」「修复了 bug」。更好的写法是:「修复移动端导航栏在 Safari 下折叠失效的问题,原因是 flex 回退方案缺少 -webkit- 前缀」。
养成好习惯:提交前花 30 秒想一下,未来翻看日志的人能不能看懂你此刻的决定。
随手记下代码片段、读书笔记,和那些一闪而过的念头。
好的提交信息就像好的注释——它们告诉你「为什么」而不是「做了什么」。代码 diff 已经显示了做了什么,但只有写代码的人知道当时为什么那样选择。
一个常见的误区是把提交信息写成流水账:「修改了样式」「修复了 bug」。更好的写法是:「修复移动端导航栏在 Safari 下折叠失效的问题,原因是 flex 回退方案缺少 -webkit- 前缀」。
养成好习惯:提交前花 30 秒想一下,未来翻看日志的人能不能看懂你此刻的决定。
纯文本,不绑定任何软件。十年后你还能打开。用 Git 做版本管理,同步到任何平台。配合 VS Code 或 Obsidian,体验不输任何商业笔记软件。
更重要的是——让你专注于内容,而不是排版。当你不用纠结标题字体选多大时,写作就回归了写作本身。
不是打断点,不是打日志,而是——先复现。稳定地把问题复现出来,就已经解决了问题的一半。很多 bug 查到最后,发现是在一个无法复现的场景下「随机」出现,那说明你对问题本质还不了解。
写一个最小复现用例,缩小范围,隔离变量。这个习惯能节省你无数个小时。
不需要托福雅思的词汇量。程序员学英语有天然的捷径:从报错信息开始。每遇到一个不认识的报错,查一下,记住——那是你工作中最常用的英语。
然后读官方文档,而不是中文翻译。刚开始很慢,但三个月后你会发现速度大幅提升。最后看技术演讲,开英文字幕,逐步过渡到无字幕。
关键是:不需要专门「学英语」,让英语成为你获取信息的默认方式。