来源书籍

代码整洁之道

Skill 版本:v24 经典原理 331 张卡片

Robert C. Martin · 韩磊 译 · 人民邮电出版社 · 2010-01-01 · 第1版 · ISBN 978-7-115-21687-8

章节与卡片

05 内容提要

16 张卡片
  1. 文件长度样本只是设计线索 理解等级:中级 普通读书笔记卡
  2. 对数轴上的距离表示倍数 理解等级:中级 普通读书笔记卡
  3. 空行可标记概念边界 理解等级:中级 普通读书笔记卡
  4. 相关代码宜减少查找距离 理解等级:中级 普通读书笔记卡
  5. 局部声明应贴近使用范围 理解等级:中级 普通读书笔记卡
  6. 成员位置应形成可预期约定 理解等级:中级 普通读书笔记卡
  7. 默认策略留在作决定的层级 理解等级:中级 普通读书笔记卡
  8. 相似操作也有布局上的内聚 理解等级:中级 普通读书笔记卡
  9. 行宽应服务于完整阅读 理解等级:中级 普通读书笔记卡
  10. 水平空格可提示表达式分组 理解等级:中级 普通读书笔记卡
  11. 水平对齐不能替代职责审视 理解等级:中级 普通读书笔记卡
  12. 缩进表达词法嵌套范围 理解等级:中级 普通读书笔记卡
  13. 空循环体应显露控制边界 理解等级:中级 普通读书笔记卡
  14. 团队格式规则应进入工具配置 理解等级:中级 普通读书笔记卡
  15. 长度统计先明确样本与单位 理解等级:中级 普通读书笔记卡
  16. 偶数样本中位数需明确约定 理解等级:中级 普通读书笔记卡

06 序

12 张卡片
  1. 封装需要隐藏表示选择 理解等级:中级 普通读书笔记卡
  2. 成组设置表达一致性边界 理解等级:中级 普通读书笔记卡
  3. 按使用问题选择数据抽象 理解等级:中级 普通读书笔记卡
  4. 扩展方向决定数据组织 理解等级:中级 普通读书笔记卡
  5. 按类型分派要处理未知输入 理解等级:中级 普通读书笔记卡
  6. 得墨忒耳律限制结构知识 理解等级:中级 普通读书笔记卡
  7. 拆开调用链不减少结构依赖 理解等级:中级 普通读书笔记卡
  8. 数据遍历与对象协作需区分 理解等级:中级 普通读书笔记卡
  9. 让对象完成目标操作 理解等级:中级 普通读书笔记卡
  10. 公开可变数据会绕过对象责任 理解等级:中级 普通读书笔记卡
  11. 传输数据不等于领域对象 理解等级:中级 普通读书笔记卡
  12. 持久化与规则边界需要选择 理解等级:中级 普通读书笔记卡

07 关于封面

13 张卡片
  1. 异常重构仍需核对业务分支 理解等级:中级 普通读书笔记卡
  2. 先定义失败后的可观察契约 理解等级:中级 普通读书笔记卡
  3. 异常控制流不自动回滚状态 理解等级:中级 普通读书笔记卡
  4. 缩小捕获前要清点全部异常 理解等级:中级 普通读书笔记卡
  5. 受检异常会传播接口义务 理解等级:中级 普通读书笔记卡
  6. 错误信息要交代失败意图 理解等级:中级 普通读书笔记卡
  7. 异常分类应对应处理差异 理解等级:中级 普通读书笔记卡
  8. 第三方边界可用本地接口隔离 理解等级:中级 普通读书笔记卡
  9. 特例对象可承接正常业务分支 理解等级:中级 普通读书笔记卡
  10. 空集合适合表达确定的零结果 理解等级:中级 普通读书笔记卡
  11. 层层判空不能代替数据契约 理解等级:中级 普通读书笔记卡
  12. 非空参数约定需要可执行边界 理解等级:中级 普通读书笔记卡
  13. 断言不应承担公开输入校验 理解等级:中级 普通读书笔记卡

08 代码猴子与童子军军规

9 张卡片
  1. 通用容器不等于业务能力 理解等级:中级 普通读书笔记卡
  2. 泛型约束与操作权限不同 理解等级:中级 普通读书笔记卡
  3. 边界封装应集中真实变化点 理解等级:中级 普通读书笔记卡
  4. 学习性测试把理解变成试验 理解等级:中级 普通读书笔记卡
  5. 观察性试验需补明确判据 理解等级:中级 普通读书笔记卡
  6. 测试配置也可能污染共享状态 理解等级:中级 普通读书笔记卡
  7. 升级边界测试只覆盖所测契约 理解等级:中级 普通读书笔记卡
  8. 未知外部接口可先定义需求 理解等级:中级 普通读书笔记卡
  9. 假实现与真实适配分层验证 理解等级:中级 结构图卡

09 前言

16 张卡片
  1. 可控时钟让时间条件可检验 理解等级:中级 普通读书笔记卡
  2. 测试应和实现一起保存 理解等级:中级 普通读书笔记卡
  3. TDD用失败限制本次增量 理解等级:中级 普通读书笔记卡
  4. 测试维护成本会反过来阻碍改动 理解等级:中级 普通读书笔记卡
  5. 测试辅助函数应突出行为意图 理解等级:中级 普通读书笔记卡
  6. 构造操作检验分开表达场景 理解等级:中级 普通读书笔记卡
  7. 测试语言应从实际场景演进 理解等级:中级 普通读书笔记卡
  8. 状态编码要保持可解读契约 理解等级:中级 普通读书笔记卡
  9. 测试与生产可有不同资源预算 理解等级:中级 普通读书笔记卡
  10. 一个测试应聚焦一个概念 理解等级:中级 普通读书笔记卡
  11. 日期加月可能不满足分步合成 理解等级:中级 普通读书笔记卡
  12. 快速反馈依赖可频繁运行 理解等级:中级 普通读书笔记卡
  13. 独立测试不借用上个测试的状态 理解等级:中级 普通读书笔记卡
  14. 可重复测试要控制必要环境 理解等级:中级 普通读书笔记卡
  15. 自足验证要自动判定预期 理解等级:中级 普通读书笔记卡
  16. 及时写测试会反馈接口可测性 理解等级:中级 普通读书笔记卡

10 第1章 整洁代码

13 张卡片
  1. 测试可访问性应先审视边界 理解等级:中级 普通读书笔记卡
  2. 类的大小应按责任理解 理解等级:中级 普通读书笔记卡
  3. 模块划分要降低理解的范围 理解等级:中级 普通读书笔记卡
  4. 内聚关注状态与行为的整体 理解等级:中级 普通读书笔记卡
  5. 局部变量升为字段会扩大生命周期 理解等级:中级 普通读书笔记卡
  6. 素数输出可分成三种变化 理解等级:中级 结构图卡
  7. 分页索引应区分边界与布局 理解等级:中级 普通读书笔记卡
  8. 奇数倍数追踪减少重复筛查 理解等级:中级 普通读书笔记卡
  9. 工具类静态状态仍然会共享 理解等级:中级 普通读书笔记卡
  10. 变动证据决定何时拆分责任 理解等级:中级 普通读书笔记卡
  11. 扩展点也有契约和组装成本 理解等级:中级 普通读书笔记卡
  12. 抽象价格源让估值条件可控 理解等级:中级 普通读书笔记卡
  13. 依赖抽象要对应稳定业务需要 理解等级:中级 普通读书笔记卡

11 第2章 有意义的命名

16 张卡片
  1. 构造策略应与运行职责分开 理解等级:中级 普通读书笔记卡
  2. 延迟创建需要失败和并发契约 理解等级:中级 普通读书笔记卡
  3. 工厂分离创建时机与细节 理解等级:中级 结构图卡
  4. 依赖注入把组装交给外部 理解等级:中级 普通读书笔记卡
  5. 注入方式不决定创建时机 理解等级:中级 普通读书笔记卡
  6. 基础设施侵入会扩大测试前提 理解等级:中级 普通读书笔记卡
  7. 横切关注面跨越领域边界 理解等级:中级 普通读书笔记卡
  8. 方面还要声明行为应用位置 理解等级:中级 普通读书笔记卡
  9. 动态代理将调用交给处理器 理解等级:中级 普通读书笔记卡
  10. 代理包装不自动提供事务一致性 理解等级:中级 普通读书笔记卡
  11. 对象注入不等于装饰器套接 理解等级:中级 普通读书笔记卡
  12. 声明映射仍然保留基础设施契约 理解等级:中级 普通读书笔记卡
  13. 架构演进依赖可替换的边界 理解等级:中级 普通读书笔记卡
  14. 可延迟决策应保留行动窗口 理解等级:中级 普通读书笔记卡
  15. 标准的价值要落到实际需要 理解等级:中级 普通读书笔记卡
  16. 领域语言缩短概念到实现的距离 理解等级:中级 普通读书笔记卡

12 第3章 函数

7 张卡片
  1. 测试反馈能暴露设计依赖 理解等级:中级 普通读书笔记卡
  2. 同一状态宜避免双份维护 理解等级:中级 普通读书笔记卡
  3. 抽取重复不会消除原有缺陷 理解等级:中级 普通读书笔记卡
  4. 模板方法固定步骤开放差异 理解等级:中级 结构图卡
  5. 模式名称要与真实角色相符 理解等级:中级 普通读书笔记卡
  6. 测试可作为行为实例文档 理解等级:中级 普通读书笔记卡
  7. 减少实体数量服从更高目标 理解等级:中级 普通读书笔记卡

13 第4章 注释

21 张卡片
  1. 并发分开任务目的与执行时机 理解等级:中级 普通读书笔记卡
  2. 复合自增可产生重复编号 理解等级:中级 普通读书笔记卡
  3. 共享状态的访问面应受控 理解等级:中级 普通读书笔记卡
  4. 数据副本减少共享仍需边界 理解等级:中级 普通读书笔记卡
  5. 请求局部引用未必指向独占对象 理解等级:中级 普通读书笔记卡
  6. 并发容器提供有边界的原子能力 理解等级:中级 普通读书笔记卡
  7. 显式可重入锁仍归线程所有 理解等级:中级 普通读书笔记卡
  8. 信号量用许可限制同时进入数 理解等级:中级 普通读书笔记卡
  9. 倒计时门闩协调完成条件 理解等级:中级 普通读书笔记卡
  10. 互斥与活性问题要分开判断 理解等级:中级 普通读书笔记卡
  11. 有界队列连接生产与消费速率 理解等级:中级 普通读书笔记卡
  12. 读写协调兼顾一致性与进度 理解等级:中级 普通读书笔记卡
  13. 多资源获取需要统一协调 理解等级:中级 普通读书笔记卡
  14. 多个同步方法不等于整段原子 理解等级:中级 普通读书笔记卡
  15. 同步范围应覆盖完整不变量 理解等级:中级 普通读书笔记卡
  16. 关闭协议必须唤醒等待者 理解等级:中级 普通读书笔记卡
  17. 偶发失败应保留为调查证据 理解等级:中级 普通读书笔记卡
  18. 并发测试宜分离业务与调度 理解等级:中级 普通读书笔记卡
  19. 调度多样性增加暴露机会 理解等级:中级 普通读书笔记卡
  20. 让步提示不释放监视器 理解等级:中级 普通读书笔记卡
  21. 调度扰动测试要可配置可追索 理解等级:中级 普通读书笔记卡

14 第5章 格式

25 张卡片
  1. 解析范式把标识映射到行为 理解等级:中级 普通读书笔记卡
  2. 输入校验顺序影响边界行为 理解等级:中级 普通读书笔记卡
  3. 共享迭代器把值消费交给类型 理解等级:中级 普通读书笔记卡
  4. 参数出现与默认值是不同事实 理解等级:中级 普通读书笔记卡
  5. 类型专用解析分开缺失与非法值 理解等级:中级 普通读书笔记卡
  6. 宽松取值可能掩盖调用类型错误 理解等级:中级 普通读书笔记卡
  7. 错误对象集中承载失败上下文 理解等级:中级 普通读书笔记卡
  8. 类型扩展仍需维护协调位置 理解等级:中级 普通读书笔记卡
  9. 失败状态与控制转移需要一致 理解等级:中级 普通读书笔记卡
  10. 类型维度的重复会扩散修改点 理解等级:中级 普通读书笔记卡
  11. 计数接口要说明统计的对象 理解等级:中级 普通读书笔记卡
  12. 设置结果不能只表示识别类型 理解等级:中级 普通读书笔记卡
  13. 替换表示时应先枚举契约触点 理解等级:中级 普通读书笔记卡
  14. 包装调用前的解引用仍会先失败 理解等级:中级 普通读书笔记卡
  15. 迁移中的集中状态只是过渡 理解等级:中级 普通读书笔记卡
  16. 统一返回类型会移动类型责任 理解等级:中级 普通读书笔记卡
  17. 双写迁移需保持同一对象身份 理解等级:中级 普通读书笔记卡
  18. 局部测试通过不代表契约已覆盖 理解等级:中级 普通读书笔记卡
  19. 错误上下文可按责任逐层补充 理解等级:中级 普通读书笔记卡
  20. 初步抽象要检查剩余职责 理解等级:中级 普通读书笔记卡
  21. 先分离错误分支再统一派发 理解等级:中级 普通读书笔记卡
  22. 统一签名应表达共同调用协议 理解等级:中级 普通读书笔记卡
  23. 新增类型要覆盖成功与失败 理解等级:中级 普通读书笔记卡
  24. 状态查询改抛异常会改变契约 理解等级:中级 普通读书笔记卡
  25. 文案归属可以是明确的折衷 理解等级:中级 普通读书笔记卡

15 第6章 对象和数据结构

8 张卡片
  1. 比较消息可压缩共同上下文 理解等级:中级 普通读书笔记卡
  2. 差异区间可以是空片段 理解等级:中级 普通读书笔记卡
  3. 偏移编码会增加边界推理成本 理解等级:中级 普通读书笔记卡
  4. 正面条件仍须准确表达责任 理解等级:中级 普通读书笔记卡
  5. 时序依赖可以由结构维护 理解等级:中级 普通读书笔记卡
  6. 改变索引约定要同步边界使用 理解等级:中级 普通读书笔记卡
  7. 空片段契约可消除无效分支 理解等级:中级 普通读书笔记卡
  8. 分析与合成可按职责分层 理解等级:中级 普通读书笔记卡

16 第7章 错误处理

17 张卡片
  1. 期望变化应与缺陷修复分开 理解等级:中级 普通读书笔记卡
  2. 严格前后星期要排除当天 理解等级:中级 普通读书笔记卡
  3. 最近星期可用循环偏移选择 理解等级:中级 普通读书笔记卡
  4. 枚举缩窄取值仍需边界转换 理解等级:中级 普通读书笔记卡
  5. 序列版本号需要兼容策略 理解等级:中级 普通读书笔记卡
  6. 实现能力可随创建策略提供 理解等级:中级 普通读书笔记卡
  7. 静态可替换工厂仍有全局状态 理解等级:中级 普通读书笔记卡
  8. 删除构造器要核对可见性契约 理解等级:中级 普通读书笔记卡
  9. 局部final表达不可重新赋值 理解等级:中级 普通读书笔记卡
  10. 行为宜靠近其解释的数据概念 理解等级:中级 普通读书笔记卡
  11. 闰年规则适用于约定历法 理解等级:中级 普通读书笔记卡
  12. 加月应先求目标再裁剪日期 理解等级:中级 普通读书笔记卡
  13. 返回新值的方法应显露结果用途 理解等级:中级 普通读书笔记卡
  14. 上移算法前须找隐含实现假设 理解等级:中级 普通读书笔记卡
  15. 区间成员资格可由枚举承载 理解等级:中级 普通读书笔记卡
  16. 仅测试调用不代表公开API无用 理解等级:中级 普通读书笔记卡
  17. 覆盖率变化需要看分母与内容 理解等级:中级 普通读书笔记卡

17 第8章 边界

22 张卡片
  1. 构建与测试应有清楚的统一入口 理解等级:中级 普通读书笔记卡
  2. 多语言混排要看认知边界 理解等级:中级 普通读书笔记卡
  3. 压制告警不等于修复原因 理解等级:中级 普通读书笔记卡
  4. 抽象能力不应要求实现撒谎 理解等级:中级 普通读书笔记卡
  5. 依赖方向影响组件独立部署 理解等级:中级 普通读书笔记卡
  6. 通用概念不宜绑在无关宿主 理解等级:中级 普通读书笔记卡
  7. 特性依恋要结合职责取舍 理解等级:中级 普通读书笔记卡
  8. 条件分支两侧须保持量纲一致 理解等级:中级 普通读书笔记卡
  9. 静态方法选择要看替换责任 理解等级:中级 普通读书笔记卡
  10. 解释性变量应命名中间角色 理解等级:中级 普通读书笔记卡
  11. 能力上限应向责任方查询 理解等级:中级 普通读书笔记卡
  12. 魔术值的问题是隐含意义 理解等级:中级 普通读书笔记卡
  13. 唯一性等假设应成为明确检查 理解等级:中级 普通读书笔记卡
  14. 整数金额仍需单位与舍入约定 理解等级:中级 普通读书笔记卡
  15. 结构约束可强化实现义务 理解等级:中级 普通读书笔记卡
  16. 通配导入不会消除实际类型依赖 理解等级:中级 普通读书笔记卡
  17. 常量访问不应伪装类型关系 理解等级:中级 结构图卡
  18. 引用方式整理不证明工资公式 理解等级:中级 普通读书笔记卡
  19. 计分过程要区分轮次与投球位置 理解等级:中级 普通读书笔记卡
  20. 忽略测试应显露未决需求 理解等级:中级 普通读书笔记卡
  21. 失败模式能指引进一步取样 理解等级:中级 普通读书笔记卡
  22. 覆盖探针帮助寻找未执行路径 理解等级:中级 普通读书笔记卡

18 第9章 单元测试

23 张卡片
  1. 性能时限应同时验证工作完成 理解等级:中级 普通读书笔记卡
  2. 调度策略可从请求处理分离 理解等级:中级 结构图卡
  3. 固定工作线程不限制积压任务 理解等级:中级 普通读书笔记卡
  4. 交错数量依赖简化执行模型 理解等级:中级 普通读书笔记卡
  5. 原子读写不等于复合动作原子 理解等级:中级 普通读书笔记卡
  6. 私有操作数栈仍可带共享引用 理解等级:中级 普通读书笔记卡
  7. Future结果等待放到汇合处 理解等级:中级 普通读书笔记卡
  8. 比较交换把条件与更新合为原子 理解等级:中级 普通读书笔记卡
  9. 原子条件插入须保护整个判断 理解等级:中级 普通读书笔记卡
  10. 取值与结束判断可合成原子入口 理解等级:中级 普通读书笔记卡
  11. 漏锁可破坏缓冲区状态不变量 理解等级:中级 问题卡
  12. 慢读取不宜占住任务分配锁 理解等级:中级 普通读书笔记卡
  13. 理想流水吞吐要声明资源假设 理解等级:中级 普通读书笔记卡
  14. 反向获取有限资源池可能死锁 理解等级:中级 问题卡
  15. 死锁分析要同时检查四个条件 理解等级:中级 普通读书笔记卡
  16. 移除互斥要匹配资源本质 理解等级:中级 普通读书笔记卡
  17. 失败释放重试仍有活性代价 理解等级:中级 普通读书笔记卡
  18. 协商释放不能当强制夺锁 理解等级:中级 普通读书笔记卡
  19. 统一资源顺序可消除等待环 理解等级:中级 普通读书笔记卡
  20. 找反例测试的绿灯有特殊含义 理解等级:中级 普通读书笔记卡
  21. ConTest扰动暴露竞争 理解等级:中级 延伸参考卡
  22. 停止标志不自动唤醒阻塞接收 理解等级:中级 普通读书笔记卡
  23. 消息内容与流帧格式需匹配 理解等级:中级 普通读书笔记卡

19 第10章 类

13 张卡片
  1. 日期值与时间点有不同契约 理解等级:中级 普通读书笔记卡
  2. final引用不会冻结格式符号 理解等级:中级 普通读书笔记卡
  3. 回退解析应重置失败状态 理解等级:中级 普通读书笔记卡
  4. 闰年累计必须说明包含端点 理解等级:中级 普通读书笔记卡
  5. 不可变承诺要说明状态范围 理解等级:中级 普通读书笔记卡
  6. 日期断言要覆盖所需完整结果 理解等级:中级 普通读书笔记卡
  7. 本地化测试需要声明语言环境 理解等级:中级 普通读书笔记卡
  8. 序列化回环不证明跨版本兼容 理解等级:中级 普通读书笔记卡
  9. 相同月份名不保证编号相同 理解等级:中级 普通读书笔记卡
  10. 往返测试不能替代外部语义判据 理解等级:中级 普通读书笔记卡
  11. 冗余表示需要同步不变量 理解等级:中级 普通读书笔记卡
  12. 克隆边界取决于对象图 理解等级:中级 普通读书笔记卡
  13. 无日期不应掩盖无效规则 理解等级:中级 普通读书笔记卡

00

8 张卡片
  1. 细节与架构共同影响维护 理解等级:中级 普通读书笔记卡
  2. 五常管理可映射代码纪律 理解等级:中级 普通读书笔记卡
  3. 易维护性要在设计时准备 理解等级:中级 普通读书笔记卡
  4. 局部修复也是持续设计 理解等级:中级 普通读书笔记卡
  5. 缩进相关不等于缺陷因果 理解等级:中级 普通读书笔记卡
  6. 代码也是设计的载体 理解等级:中级 普通读书笔记卡
  7. 如实暴露代码状态才能改进 理解等级:中级 普通读书笔记卡
  8. 学习规则要追踪具体决策 理解等级:中级 普通读书笔记卡

01

18 张卡片
  1. 自动化仍需明确执行语义 理解等级:中级 普通读书笔记卡
  2. 可运行不等于可持续维护 理解等级:中级 普通读书笔记卡
  3. 混乱会放大修改的理解负担 理解等级:中级 普通读书笔记卡
  4. 整体重写需追赶现有系统变化 理解等级:中级 普通读书笔记卡
  5. 风险沟通属于开发责任 理解等级:中级 普通读书笔记卡
  6. 辨认缺陷与安排变换不同 理解等级:中级 普通读书笔记卡
  7. 集中责任有助于表达意图 理解等级:中级 普通读书笔记卡
  8. 直接控制流让设计意图可读 理解等级:中级 普通读书笔记卡
  9. 可读与可增补是不同能力 理解等级:中级 普通读书笔记卡
  10. 测试为修改提供行为约束 理解等级:中级 普通读书笔记卡
  11. 少量明确接口降低依赖负担 理解等级:中级 普通读书笔记卡
  12. 简单设计规则有优先顺序 理解等级:中级 普通读书笔记卡
  13. 重复可能暴露未表达的概念 理解等级:中级 普通读书笔记卡
  14. 小型抽象隔离查找实现 理解等级:中级 普通读书笔记卡
  15. 接口应使下一步行为可预期 理解等级:中级 普通读书笔记卡
  16. 规则流派需要按约束检验 理解等级:中级 普通读书笔记卡
  17. 为读者降低修改前的理解成本 理解等级:中级 普通读书笔记卡
  18. 每次修改留下局部改善 理解等级:中级 普通读书笔记卡

02

23 张卡片
  1. 名称同时说明对象与单位 理解等级:中级 普通读书笔记卡
  2. 领域命名能显露筛选意图 理解等级:中级 普通读书笔记卡
  3. 行为接口可隐藏状态表示 理解等级:中级 普通读书笔记卡
  4. 名称不应暗示不存在的能力 理解等级:中级 普通读书笔记卡
  5. 视觉差异也影响名称辨别 理解等级:中级 普通读书笔记卡
  6. 不同名称应说明不同角色 理解等级:中级 普通读书笔记卡
  7. 可读出的名字便于协作讨论 理解等级:中级 普通读书笔记卡
  8. 可搜索性应匹配名称作用域 理解等级:中级 普通读书笔记卡
  9. 类型编码可能落后于真实类型 理解等级:中级 普通读书笔记卡
  10. 成员身份可由局部语境表达 理解等级:中级 普通读书笔记卡
  11. 公开接口名称优先表达角色 理解等级:中级 普通读书笔记卡
  12. 名字应减少额外的心智翻译 理解等级:中级 普通读书笔记卡
  13. 类名应显露对象承担的角色 理解等级:中级 普通读书笔记卡
  14. 方法名称应对应实际业务责任 理解等级:中级 普通读书笔记卡
  15. 命名工厂能说明构造参数含义 理解等级:中级 普通读书笔记卡
  16. 笑话名称会增加文化依赖 理解等级:中级 普通读书笔记卡
  17. 同一概念宜保持词汇一致 理解等级:中级 普通读书笔记卡
  18. 相同词不应掩盖不同操作 理解等级:中级 普通读书笔记卡
  19. 名称来源取决于概念所属 理解等级:中级 普通读书笔记卡
  20. 对象语境能组织相关字段 理解等级:中级 结构图卡
  21. 项目标签不必污染所有名称 理解等级:中级 普通读书笔记卡
  22. 精确限定优于无关的长前缀 理解等级:中级 普通读书笔记卡
  23. 重命名应验证引用边界 理解等级:中级 普通读书笔记卡

03

27 张卡片
  1. FitNesse用页面组织测试 理解等级:中级 延伸参考卡
  2. 抽取调用仍需核对行为边界 理解等级:中级 普通读书笔记卡
  3. 函数行数阈值只是经验 理解等级:中级 普通读书笔记卡
  4. 同层步骤应隐藏下一层实现 理解等级:中级 普通读书笔记卡
  5. 向下阅读使调用层次可追踪 理解等级:中级 普通读书笔记卡
  6. 单一职责关注变化理由 理解等级:中级 普通读书笔记卡
  7. 开闭原则围绕选定变化扩展 理解等级:中级 普通读书笔记卡
  8. 工厂可集中对象类型分派 理解等级:中级 结构图卡
  9. 命名困难可提示职责混合 理解等级:中级 普通读书笔记卡
  10. 参数数量不能独立衡量复杂度 理解等级:中级 普通读书笔记卡
  11. 一元调用要区分查询与转换 理解等级:中级 普通读书笔记卡
  12. 事件入口应显露状态改变 理解等级:中级 普通读书笔记卡
  13. 布尔开关可能混合两套动作 理解等级:中级 普通读书笔记卡
  14. 多个参数需要角色与顺序线索 理解等级:中级 普通读书笔记卡
  15. 浮点容限要对应比较目标 理解等级:中级 普通读书笔记卡
  16. 参数对象应表示共同概念 理解等级:中级 普通读书笔记卡
  17. 变长参数仍要说明元素角色 理解等级:中级 普通读书笔记卡
  18. 隐含副作用会产生时序依赖 理解等级:中级 问题卡
  19. 接口应让数据修改方向可见 理解等级:中级 普通读书笔记卡
  20. 查询与动作应有清楚的结果语义 理解等级:中级 普通读书笔记卡
  21. 异常可分开失败路径与主流程 理解等级:中级 普通读书笔记卡
  22. 错误处理边界也需要明确责任 理解等级:中级 普通读书笔记卡
  23. 共享错误表会扩大语义依赖 理解等级:中级 普通读书笔记卡
  24. 共享步骤应显式表达差异 理解等级:中级 普通读书笔记卡
  25. 提前返回也可保持局部清晰 理解等级:中级 普通读书笔记卡
  26. 先建立行为再迭代函数结构 理解等级:中级 普通读书笔记卡
  27. 调用级对象可收拢渲染上下文 理解等级:中级 结构图卡

04

24 张卡片
  1. 注释需要随所指代码共同维护 理解等级:中级 普通读书笔记卡
  2. 固定发布声明不等于功能注解 理解等级:中级 普通读书笔记卡
  3. 说明意图不等于证明方案正确 理解等级:中级 普通读书笔记卡
  4. 失败标记不能代替完成等待 理解等级:中级 问题卡
  5. 外部接口的约定可就地阐明 理解等级:中级 普通读书笔记卡
  6. 比较结果应先按符号解释 理解等级:中级 普通读书笔记卡
  7. 警示应保留危险条件与理由 理解等级:中级 普通读书笔记卡
  8. 共享格式器须明确同步边界 理解等级:中级 普通读书笔记卡
  9. TODO记录待办而非完成证据 理解等级:中级 普通读书笔记卡
  10. 注释可解释看似多余的操作 理解等级:中级 普通读书笔记卡
  11. 公共文档应补足调用者契约 理解等级:中级 普通读书笔记卡
  12. 注释不能凭空补出恢复行为 理解等级:中级 问题卡
  13. 注释须提供名称之外的信息 理解等级:中级 普通读书笔记卡
  14. 条件变化不会自动唤醒等待者 理解等级:中级 问题卡
  15. 变更历史宜保存在版本记录中 理解等级:中级 普通读书笔记卡
  16. 定位标记不能替代清楚结构 理解等级:中级 普通读书笔记卡
  17. 注释代码不应充当长期备份 理解等级:中级 普通读书笔记卡
  18. 文档格式要兼顾源码与生成物 理解等级:中级 普通读书笔记卡
  19. 说明应靠近事实的维护来源 理解等级:中级 普通读书笔记卡
  20. Base64把三字节映成四符号 理解等级:中级 普通读书笔记卡
  21. 注释应把常量与原因对应起来 理解等级:中级 普通读书笔记卡
  22. 筛法按小因子排除合数 理解等级:中级 普通读书笔记卡
  23. 空数组与空引用不是一回事 理解等级:中级 普通读书笔记卡
  24. 抽取函数不消除静态共享状态 理解等级:中级 结构图卡

全书概览

代码整洁之道

Skill 版本:v24

执行模式:light

建档进度:done

信息浓度:高

稳定性:高(知识主体较耐久)

四象限:经典原理

评级依据:沿用总表高浓度/高稳定性(经典原理)。评级实读样本:内容提要、序/译序/前言、第1章全部正文,以及第14章首单元Args的接口/解析映射代码、第17章首单元注释/构建/参数启发。它们不仅罗列语法,还解释重复、表达、维护成本和逐步改进的理由;命名、职责与边界等主体可迁移。具体Java/JUnit/JCommon/并发库和命令仍带版本条件,作者门派式建议与启发不作为数学定律或全部项目最佳方案。评级抽样不代表后续案例或附录已读,全部正文仍逐单元处理。

整书笔记(全文讲解与定位已完成);覆盖记录。本次按book-notes –mode light,未执行生成后复核、独立审查及审查优化。

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
005 内容提要 done 0
006 序 done 7
007 关于封面 done 0
008 代码猴子与童子军军规 done 0
009 前言 done 1
010 第1章 整洁代码 done 18
011 第2章 有意义的命名 done 23
012 第3章 函数 done 27
013 第4章 注释 done 24
014 第5章 格式 done 16
015 第6章 对象和数据结构 done 12
016 第7章 错误处理 done 13
017 第8章 边界 done 9
018 第9章 单元测试 done 16
019 第10章 类 done 13
020 第11章 系统 done 16
021 第12章 迭进 done 7
022 第13章 并发编程 done 21
023 第14章 逐步改进 done 25
024 第15章 JUnit内幕 done 8
025 第16章 重构SerialDate done 17
026 第17章 味道与启发 done 22
027 附录A 并发编程II done 23
028 附录B org.jfree.date.SerialDate done 13
029 结束语 done 0

非正文排除

spine项 类型 排除理由
001 封面 仅图片封面,无独立正文
002 目录 导航目录;具体正文按spine顺序列入,不以目录代替阅读
003 扉页 书名作者译者出版社身份页,信息写元数据,不作为技术正文
004 版权 CIP/版权与出版发行信息,已全文核对用于出版元数据

待关联术语

术语名 出现章节 一句话语境
CAS、Future、ExecutorService、Callable、操作数栈、四个死锁条件 027 附录机制展开,字节码交错公式为简化模型,示例未执行
Feature Envy、最小惊异原则、DRY、Strategy、Codd Normal Forms、共同语言 026 前三者有实质讨论并入/成卡;Strategy/范式仅提名不补造全集
DayDate、SpreadsheetDate、DayDateFactory、DateInterval、解释临时变量 025 日期抽象/实现能力/边界语义,附录全文已完成读取
ComparisonCompactor、共同前缀/后缀、contextLength 024 单区间差异消息及有限上下文,非通用最小编辑diff
Args、范式字符串、ArgumentMarshaler、ArgsException 023 本书自写参数解析协议与渐进重构例,不作通用CLI库使用指南
临界区、互斥、饥饿、死锁、活锁、ReentrantLock、Semaphore、CountDownLatch、Executor 022 表13-1/2及执行模型;线程所有权、许可和一次性条件有不同契约
简单设计、单一事实来源、Template Method 021 按优先顺序迭进,共同算法/差异钩子不补造地区业务规则
DI、IoC、JNDI、POJO、横切关注面、AOP、BDUF、DSL 020 组装、运行及策略边界;创建时机/不手改源码/提前设计均需区分
SRP、内聚、OCP、DIP、StockExchange 019 类责任、变化隔离与询价抽象;原则按实际变化轴而非方法数量判断
BUILD-OPERATE-CHECK、given-when-then、测试DSL、FIRST、Template Method 018 场景表达与测试质量;模板法仅提名,不补造模式实现
learning tests、Adapter、seam、FakeTransmitter 017 API理解的试验与受控替换接缝;假实现验证和真实适配验证需区分
checked exception、unchecked exception、Special Case 016 编译期处理义务与正常业务特例;非受检不等于不可捕获,特例不是吞没失败
DTO、Active Record、Visitor、双向分派 015 传输与持久化角色及扩展轴例外;Active Record按本书建议与Fowler定义区分
对数标尺、标准差σ、直方图、中位数 014 图与CodeAnalyzer实际计量所涉;样本数据和σ解释不完整,不补造实验结论
Javadoc、TODO、伪唤醒、筛法、Base64 013 对应注释职责、待办与样例中实质机制;不会把完整代码样板当已验证工具
单一职责SRP、开闭OCP、DRY、指令询问分隔、结构化编程 012 已按实际解释保留变化理由/扩展边界/共同步骤/接口责任/退出取舍,历史理论全貌不补造
匈牙利语标记法、抽象工厂、Visitor、JobQueue 011 名称编码与术语来源的情境例;模式未在本章完整展开,不增造机制卡
单一权责原则SRP、开放闭合原则OCP、依赖倒置原则DIP 010 仅预告后续引用,未在本章独立解释,留待正文展开
领域特定语言DSL、破窗比喻、LeBlanc警语、字面编程 010 精确表达及持续照料的背景线索,不把格言当实证规律
TPM、精益、Scrum、TDD、耦合与内聚 006 序言维护与设计论证中提名,具体机制留待后文

引用文献

标题 类型(书/论文/框架/源码项目) 出现章节 一句话语境
SpreadsheetDate、RelativeDayOfWeekRule与DayDate最终实现 源码项目 028 B-5/B-6与B-7至B-16完整读取;原书省略许可段不补造;未执行代码
SerialDateTests.java、MonthConstants.java、BobsSerialDateTest.java 源码项目 028 B-2/B-3/B-4完整读;测试仅为源码证据,未在本机执行
org.jfree.date.SerialDate.java 源码项目 028 B-1本地历史文件,版本注释2005-11-03 v1.7,完整1034原行已读
ConTest 源码项目 027 A8介绍装置与运行流程,实质内容生成延伸参考卡,当前可用性未核
Implementation Patterns 书 026 Kent Beck,本书参考表列2008,解释变量引文
Domain Driven Design 书 026 Eric Evans,2003,共同语言引文
Hardcore Java 书 025 Robert Simmons Jr.,2004,final风格主张的对照引文
Smalltalk Best Practice Patterns 书 025 Kent Beck,1997,解释临时变量参考
JCommon / org.jfree.date.SerialDate 源码项目 025 本书历史重构对象,本文片段与完整附录分开阅读
JUnit Pocket Guide 书 024 Kent Beck,O’Reilly,2004,p43起源叙事引用
JUnit、FitNesse 框架/源码项目 023 作者单元/验收回归的叙事,未在本轮执行测试
Concurrent Programming in Java: Design Principles and Patterns 书 022 Doug Lea,第二版1999,库与模型参考
The Pragmatic Programmer 书 022 Hunt/Thomas,本书列2000,DRY引用
IBM ConTest 源码项目 022 原书调度扰动工具提名,未核当前可用性/未运行
Extreme Programming Explained: Embrace Change 书 021 Kent Beck,1999,简单设计四规则引用
Inversion of Control Containers and the Dependency Injection pattern 文章 020 Martin Fowler,依赖注入引用线索
XUnit Patterns 书 020 原书列Gerard Mezzaros,2007,测试替身参考
A Timeless Way of Building 书 020 Christopher Alexander,1979,城市/领域语言背景
Eclipse AspectJ 书 020 Colyer等,2005,方面工具参考
Software physics and computer performance measurements 论文 020 Kolence,1972,软件物理仅引文
ASM、CGLIB、Javassist、AspectJ、JBoss AOP、Spring、JMock 框架/源码项目 020 代理/方面/DSL工具提名,历史配置不作当前使用指引
Object Design: Roles, Responsibilities, and Collaborations 书 019 Rebecca Wirfs-Brock等,2002,权责定义参考
Literate Programming 书 019 Donald E. Knuth,1992,PrintPrimes为本书所用改编Java例
RSpec: Behavior Driven Development for Ruby Programmers 书 018 本书所列Hellesøy/Chelimsky,2008,given-when-then语境
Professionalism and Test-Driven Development 论文 018 Robert C. Martin,IEEE Software,2007,三定律引文
Test Driven Development 书 017 Kent Beck,2003,学习性测试引文
Design Patterns: Elements of Reusable Object Oriented Software 书 017 Gamma等,本书标1996,Adapter引用线索
Working Effectively with Legacy Code 书 017 2004,seam接缝引文
Apache log4j 框架 017 历史日志配置探索,不作当前版本用法指引
Agile Software Development: Principles, Patterns, and Practices 书 016 Robert C. Martin,2002,受检异常讨论的参考来源
Refactoring: Improving the Design of Existing Code 书 015 1999年Martin Fowler等著,脚注联系特性依恋,本章未展开重构全集
Law of Demeter 设计原则/研究项目 015 近邻协作与结构依赖,核对原项目对象形式限定简写
JUnit4.3.1、TestNG、Time and Money、JDepend、Ant、Tomcat、FitNesse 框架/源码项目 014 历史样本分布与布局例,不作为当期版本尺寸或质量比较
RFC2045第6.8节 规范 013 Base64完整组编码机制被原书引用,本轮仅解释实际摘录,不声称读完RFC全文
JavaSE21 Object.wait、Comparable、SimpleDateFormat 规范/源码项目 013 生成时核对等待条件/比较符号/格式器共享边界
Tomcat、Apache Commons、JUnit4、The Elements of Programming Style 框架/源码项目/书 013 注释样例与警示的来源,未宣称本机安装或执行
The Elements of Programming Style、Design Patterns、Structured Programming 书 012 向下阅读、工厂和结构化控制背景,未声称阅读全文
JUnit、FitNesse 框架/源码项目 012 单元测试与Web测试页示例,FitNesse代码标20070619历史版本
Java语言规范SE21第13章、JUnit4.13.2 Assert 规范/源码项目 012 生成时核对枚举/throws二进制兼容与浮点delta含义,非运行验证
JavaBeans规范 框架/规范 011 get/set/is属性约定的原书来源提名,未假定所有语言和接口必须遵守
The Pragmatic Programmer、Object Oriented Analysis and Design with Applications、Working Effectively with Legacy Code 书 010 破窗比喻、可读结构、代码照料的被引背景,未声称读完原书
Extreme Programming Installed、Extreme Programming Adventures in C#、The C++ Programming Language 书 010 整洁代码定义与实践者背景引用,具体保留本章实际观点
The Elements of C# Style(C#编程风格)、Object Mentor 书/源码项目 008 译者经历与作者流派背景,未展开接口或独立机制
Implementation Patterns(实现模式)、Literate Programming(字面编程)、Agile Software Development: Principles, Patterns, and Practices 书 006、010 已读前置与第1章的设计/表达背景,未声称阅读被引原书
Christopher Alexander模式语言、Abstraction Descant 书/论文 006 持续局部修复及抽象讨论的引用,未展开完整体系

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 沿比较消息追踪差异边界 实现深读 done 15 ideas/idea-001-沿比较消息追踪差异边界.md;已核验固定标签/提交、4文件、首轮映射与两层计划
002 把局部改善限定在一次修改 行为实验 done 1、15 ideas/idea-002-把局部改善限定在一次修改.md;7日基线/干预计划,尚未执行

实践候选筛选:done

采用:JUnit固定实现深读;本地辅助脚本局部改善行为实验。合并:空差异/前后缀/上下文裁剪并入同一源码计划。暂不采用:重写Args或日期库,已有成熟源码可读且不需要重复实现;并发故障实验不作为当前最小实践。两卡为计划交付,完整实践未执行。

全书收束:25项实质正文、172单元已读并生成;331知识卡、2实践计划。全书主线/跨章综合与实践入口已写整书笔记。轻量模式:未执行复核、审查及审查结果优化。

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

暂无公开主题。