你有没有这样的时刻：翻开三个月前自己写的代码，愣了两秒，然后小声嘀咕一句——“这谁写的，怎么连个注释都没有？”紧接着，你看到了提交记录里的名字，是你自己。
这一刻的尴尬，其实是一封迟到的信。三个月前的你，急着赶完一个功能，心想“先这样，以后再优化”，然后头也不回地奔向下一个任务。三个月后的你，则在为那行潦草的代码付利息——多花十分钟去读懂，多花半小时去确认它到底会不会踩坑。
写代码，本质上是一种留言
我们总以为代码是写给机器执行的，这没错。但代码首先是写给人读的——而那个最早的读者，是未来的你自己。机器不在意你变量叫 a 还是叫 retryCountAfterTimeout，它一样跑；可凌晨两点排查线上问题的你，在意。
所以，给变量起一个清楚的名字，是温柔；把那个绕了一圈才走通的逻辑写一行注释说清“为什么”，是温柔；把一个三百行的函数拆成三个各司其职的小函数，也是温柔。这些温柔不会让你今天早下班，但它们会让三个月后的你，不必在凌晨对着屏幕骂自己。
代码的真正成本，不在写出来的那一刻，而在之后每一次被读、被改、被排查的时刻。
有人把这叫可维护性，听起来是个冷冰冰的工程术语。可你若把它当成人与人之间的事——把下一位读者当成一个疲惫的、需要被善待的人——很多选择就不再纠结了。你不会随手扔一个空异常让人去猜，就像你不会在朋友找不到路的时候一声不吭。
把未来的自己，当成一个需要帮助的朋友
这听起来有点矫情，但它真有用。当你写下一段略显 tricky 的逻辑时，不妨停三秒，问一句：三个月后，我还能一眼看懂这里在干嘛吗？如果答案是否定的，那就再补一句注释，或者换个更直白的写法。这点时间，比起将来你或别人为此付出的排查成本，划算得多。
写代码的年头越久，我越觉得，衡量一个人水平的不只是他能写出多巧妙的逻辑，更是他留下来的代码，是否让后来的人感到安心。那些平实、清楚、甚至略显朴素的代码，背后藏着的，其实是一种成熟的体贴。
所以，下次当你写完一段功能，准备合上电脑之前，再读一遍它吧——不是以作者的身份，而是以一个陌生读者的身份。如果你读得顺畅，那便是你写给未来自己的一封，温柔的信。
愿你写下的每一行，都对得起将来翻开它的那个人。哪怕那个人，就是你自己。
Written by slamkun