uki

为什么好的代码首先是给人读的

机器能跑通的代码很多,能让同事一眼看懂的却很少。

谭宇
@tan_nocode
March 16, 2026

刚入行的程序员常常以为,写代码的目标就是让程序正确运行。这当然没错,但只说对了一半。真正区分新手与资深工程师的,往往不是谁能让代码跑起来,而是谁写出的代码,半年后别人——甚至自己——还能轻松看懂。

一段代码在它的生命周期里,被阅读的次数远远多于被编写的次数。修复缺陷、添加功能、排查线上问题,每一次都要先读懂现有逻辑。如果变量名含混、函数动辄上百行、控制流层层嵌套,那么每一次改动都像在雷区里挪步,既慢又危险。可读性差的代码,本质上是在向未来不断借债。

提升可读性并不需要高深技巧,更多是习惯。给变量和函数起一个诚实的名字,让它说出自己真正在做的事;把一个庞大的函数拆成几个职责清晰的小函数;删掉那些『以防万一』却从未生效的注释和死代码。这些都是小事,但累积起来,决定了一个项目是越改越顺还是越改越乱。

也有人担心,过度追求整洁会拖慢进度。短期看也许如此,但软件几乎总是活得比预期更久。今天为了赶工塞进去的混乱,明天会以更高的利息连本带利还回来。真正快的团队,往往是那些舍得在清晰上花时间的团队。

所以,下次写完一个功能,不妨多花五分钟,假装自己是一个刚接手这段代码的陌生人,从头读一遍。如果连你都要皱眉思考,那它就还没有真正完成。代码是写给机器执行的,但更是写给人理解的。