11 条程序员应该遵守的规则(John Sonmez,公众号笔记)
ABSTRACT
2017-12 收藏的译文笔记(原作者 John Sonmez)。11 条开发者自律规则:技术是手段不是目的、清晰优于聪明、非必要不写代码、注释是魔鬼、交付前自测、每天学习、最佳实践因地制宜、力求精简等。
核心要点
- 规则的价值:提前做决定,避免匆忙中决策(GTD 实践)。
- 技术是到达解决方案的路径,本身不是方案;警惕拿着锤子看什么都像钉子的技术狂热。
- 「聪明」是「清晰」的敌人:能表明意图的代码永远比晦涩的聪明代码有价值。
- 只在逼不得已时写代码:为臆想需求写的「健壮灵活」代码是负担——代码越多,错误与维护成本越高;伟大工程师删掉没用的代码。
- 注释是魔鬼:注释代表表达能力的欠缺,优先用好命名;注释不随代码更新会「撒谎」。(笔记作者批注:对中等英文水平的中国团队协作场景持保留态度。)
- 写代码前先百分百想清楚它要做什么;TDD 有帮助,但理解需求更根本。
- 交付前自测:质量是每个人的工作,不是 QA 的。
- 每天学点新东西:不学就在退步;每天 15 分钟阅读即可,小进步复利重塑未来。
- 承认无法全知:重点学需要知道的,提升高效学习的能力。
- 最佳实践因地制宜:原则是永恒的,最佳实践是变通的。
- 力求精简:所有问题都可分解,最佳方案往往最简单;傻瓜才给复杂方案。
关键实体与概念
GTD、TDD、Clean Code(Robert C. Martin)、技术选型、持续学习、极简主义
关联概念
来源回溯
- 原始文件:
raw/ip/wechat_articles/11条程序员应该遵守的规则.md(2017-12-07)
时效性评估
- 仍有效:11 条均为原则层建议(清晰、精简、自测、持续学习),不依赖任何技术栈,长期有效;「原则永恒、实践变通」尤其值得引用。
- 已过时:AI 辅助编程(Copilot/大模型)时代,「只在必要时写代码」演进为「只在必要时保留代码」——生成成本降低但审查与维护成本不变;「注释是魔鬼」之争在 AI 生成代码语境下有了新的平衡(为 AI 写清意图注释反而重要)。核心原则不受影响。