语言编程是什么
“语言编程”容易让人联想到用自然语言直接生成代码,但更务实的理解是:把写文章的能力用在写代码上。代码首先是给人读的,其次才是给机器执行的。命名是否达意、句式是否清晰、结构是否有层次,直接决定一段代码能不能被维护。
命名是最小的语言单元
变量名和函数名是代码里的“词”。好的命名遵循三条朴素规则:
- 说清楚是什么,而不是怎么来的:
userList优于data2。 - 动词开头表示动作:
fetchOrder、validateInput。 - 避免缩写歧义:
cnt不如count,tmp不如tempBuffer。
写命名时问自己一句:换个人只看这个名字,能不能猜出用途?这跟写标题的要求是一样的。
句子要短,主语要明确
函数体像段落,一行代码像一句话。一句话塞进三个嵌套调用,读者就得来回断句。把复杂表达式拆成几个中间变量,等于给长句加了标点。条件判断尽量写成肯定式,if (isValid) 比 if (!isInvalid) 少一次心智反转。
结构对应文章骨架
一篇结构清晰的文章有开头、主体、收尾;一个清晰的模块有入口、核心逻辑、边界处理。常见做法是:
- 公开接口放在文件顶部,内部实现往下沉。
- 相关逻辑聚在一起,不相关的不交叉。
- 注释解释“为什么”,代码本身表达“是什么”。
用语言习惯反查代码问题
一个实用技巧:把一段代码逐行念出来。念着别扭的地方,往往就是可读性差的地方。比如“如果用户不为空并且订单状态不是未支付且库存大于零”,念完已经忘了前半句——这就是该抽成独立函数或变量的信号。
可操作的练习
- 每天挑一个自己写过的函数,重写它的名字和内部变量名,对比前后差异。
- 把一段超过二十行的逻辑,用三句话概括成注释,再按注释拆分函数。
- 读优秀开源项目的源码,只看命名和注释,判断作者意图是否一目了然。
语言编程的核心不是工具,而是一种自觉:写代码时始终假设读者在场。命名准确、句式简短、结构分明,这三件事做到,代码质量就会有可见的提升。