可读性不是代码完成之后的装饰。它决定了一个团队能否安全地修改系统,也决定知识能否离开作者继续流动。
命名是在压缩上下文
一个准确的名字省下的不只是注释,也省下了读者在多个文件之间来回跳转的精力。命名应说明业务意图,而不是重复实现细节。
让结构替你解释
当函数足够短、边界足够清楚、数据流向足够直接,大部分解释会自然消失。不是因为代码变少,而是因为理解它需要同时记住的事情变少了。
可读性不是代码完成之后的装饰。它决定了一个团队能否安全地修改系统,也决定知识能否离开作者继续流动。
一个准确的名字省下的不只是注释,也省下了读者在多个文件之间来回跳转的精力。命名应说明业务意图,而不是重复实现细节。
当函数足够短、边界足够清楚、数据流向足够直接,大部分解释会自然消失。不是因为代码变少,而是因为理解它需要同时记住的事情变少了。