程序员的README(克里斯·里科米尼德米特里·里)

书: https://pan.baidu.com/s/1XqKbodMZYD_Bu2f_E1ghxw?pwd=y5p9
笔记如下:

  1. “代码是负债,不是资产——可维护性比聪明更重要。”
  2. git commit -m的黄金格式:<类型>(<范围>):<主题>,如feat(auth): add OAuth2 login。”
  3. “代码审查(CR)的核心是‘找问题,而非找茬’,每行注释必须提供改进建议。”
  4. “文档四象限:Why(设计目的)、How(使用指南)、What(API参考)、Gotchas(坑点预警)。”
  5. README.md的第一段必须回答:‘这个项目是做什么的?为什么存在?如何5分钟内跑起来?’”
  6. “日志分级:DEBUG(调试)、INFO(关键流程)、WARN(可恢复错误)、ERROR(需人工干预)。”
  7. “‘橡皮鸭调试法’:向非技术同事解释问题,50%的情况你会自己找到答案。”
  8. “技术债管理:用TODO(owner): context标注债务,定期召开‘清算会议’。”
  9. “生产环境三原则:不手动改数据、不直接登录服务器、变更必须通过CI/CD流水线。”
  10. on-call生存指南:故障分级(P0-P4)、预案手册(Runbook)、事后必须写复盘报告(Postmortem)。”
  11. “架构设计文档(ADR)模板:问题陈述、决策选项、选定方案、妥协代价。”
  12. “测试金字塔:70%单元测试(快速)、20%集成测试(模块间)、10%E2E测试(全链路)。”
  13. “代码重构的勇气:每次修改功能时,顺手改善周边代码(‘童子军规则’)。”
  14. ssh到生产机的最后防线:--dry-run先模拟,tmux防断连,alias禁用危险命令。”
  15. “职业发展悖论:深度(专家)让你被需要,广度(通才)让你不可替代。”
  16. “会议成本公式:时薪×人数×时长——站着开会效率提升50%。”
  17. “‘痛苦驱动开发’:工具链的优化优先级=使用频率×单次耗时。”
  18. “职场政治免疫力:用数据(metrics)代替观点(opinions)争论。”
  19. “程序员的三重价值:产出代码(What)、传递知识(How)、定义标准(Why)。”
  20. “终极README:你的职业不是写代码,而是用代码解决问题。”

发表评论

您的电子邮箱地址不会被公开。 必填项已用 * 标注