来源书籍
代码整洁之道
章节与卡片
05 内容提要
16 张卡片
- 文件长度样本只是设计线索 理解等级:中级 普通读书笔记卡
- 对数轴上的距离表示倍数 理解等级:中级 普通读书笔记卡
- 空行可标记概念边界 理解等级:中级 普通读书笔记卡
- 相关代码宜减少查找距离 理解等级:中级 普通读书笔记卡
- 局部声明应贴近使用范围 理解等级:中级 普通读书笔记卡
- 成员位置应形成可预期约定 理解等级:中级 普通读书笔记卡
- 默认策略留在作决定的层级 理解等级:中级 普通读书笔记卡
- 相似操作也有布局上的内聚 理解等级:中级 普通读书笔记卡
- 行宽应服务于完整阅读 理解等级:中级 普通读书笔记卡
- 水平空格可提示表达式分组 理解等级:中级 普通读书笔记卡
- 水平对齐不能替代职责审视 理解等级:中级 普通读书笔记卡
- 缩进表达词法嵌套范围 理解等级:中级 普通读书笔记卡
- 空循环体应显露控制边界 理解等级:中级 普通读书笔记卡
- 团队格式规则应进入工具配置 理解等级:中级 普通读书笔记卡
- 长度统计先明确样本与单位 理解等级:中级 普通读书笔记卡
- 偶数样本中位数需明确约定 理解等级:中级 普通读书笔记卡
06 序
12 张卡片
- 封装需要隐藏表示选择 理解等级:中级 普通读书笔记卡
- 成组设置表达一致性边界 理解等级:中级 普通读书笔记卡
- 按使用问题选择数据抽象 理解等级:中级 普通读书笔记卡
- 扩展方向决定数据组织 理解等级:中级 普通读书笔记卡
- 按类型分派要处理未知输入 理解等级:中级 普通读书笔记卡
- 得墨忒耳律限制结构知识 理解等级:中级 普通读书笔记卡
- 拆开调用链不减少结构依赖 理解等级:中级 普通读书笔记卡
- 数据遍历与对象协作需区分 理解等级:中级 普通读书笔记卡
- 让对象完成目标操作 理解等级:中级 普通读书笔记卡
- 公开可变数据会绕过对象责任 理解等级:中级 普通读书笔记卡
- 传输数据不等于领域对象 理解等级:中级 普通读书笔记卡
- 持久化与规则边界需要选择 理解等级:中级 普通读书笔记卡
07 关于封面
13 张卡片
- 异常重构仍需核对业务分支 理解等级:中级 普通读书笔记卡
- 先定义失败后的可观察契约 理解等级:中级 普通读书笔记卡
- 异常控制流不自动回滚状态 理解等级:中级 普通读书笔记卡
- 缩小捕获前要清点全部异常 理解等级:中级 普通读书笔记卡
- 受检异常会传播接口义务 理解等级:中级 普通读书笔记卡
- 错误信息要交代失败意图 理解等级:中级 普通读书笔记卡
- 异常分类应对应处理差异 理解等级:中级 普通读书笔记卡
- 第三方边界可用本地接口隔离 理解等级:中级 普通读书笔记卡
- 特例对象可承接正常业务分支 理解等级:中级 普通读书笔记卡
- 空集合适合表达确定的零结果 理解等级:中级 普通读书笔记卡
- 层层判空不能代替数据契约 理解等级:中级 普通读书笔记卡
- 非空参数约定需要可执行边界 理解等级:中级 普通读书笔记卡
- 断言不应承担公开输入校验 理解等级:中级 普通读书笔记卡
08 代码猴子与童子军军规
9 张卡片
- 通用容器不等于业务能力 理解等级:中级 普通读书笔记卡
- 泛型约束与操作权限不同 理解等级:中级 普通读书笔记卡
- 边界封装应集中真实变化点 理解等级:中级 普通读书笔记卡
- 学习性测试把理解变成试验 理解等级:中级 普通读书笔记卡
- 观察性试验需补明确判据 理解等级:中级 普通读书笔记卡
- 测试配置也可能污染共享状态 理解等级:中级 普通读书笔记卡
- 升级边界测试只覆盖所测契约 理解等级:中级 普通读书笔记卡
- 未知外部接口可先定义需求 理解等级:中级 普通读书笔记卡
- 假实现与真实适配分层验证 理解等级:中级 结构图卡
09 前言
16 张卡片
- 可控时钟让时间条件可检验 理解等级:中级 普通读书笔记卡
- 测试应和实现一起保存 理解等级:中级 普通读书笔记卡
- TDD用失败限制本次增量 理解等级:中级 普通读书笔记卡
- 测试维护成本会反过来阻碍改动 理解等级:中级 普通读书笔记卡
- 测试辅助函数应突出行为意图 理解等级:中级 普通读书笔记卡
- 构造操作检验分开表达场景 理解等级:中级 普通读书笔记卡
- 测试语言应从实际场景演进 理解等级:中级 普通读书笔记卡
- 状态编码要保持可解读契约 理解等级:中级 普通读书笔记卡
- 测试与生产可有不同资源预算 理解等级:中级 普通读书笔记卡
- 一个测试应聚焦一个概念 理解等级:中级 普通读书笔记卡
- 日期加月可能不满足分步合成 理解等级:中级 普通读书笔记卡
- 快速反馈依赖可频繁运行 理解等级:中级 普通读书笔记卡
- 独立测试不借用上个测试的状态 理解等级:中级 普通读书笔记卡
- 可重复测试要控制必要环境 理解等级:中级 普通读书笔记卡
- 自足验证要自动判定预期 理解等级:中级 普通读书笔记卡
- 及时写测试会反馈接口可测性 理解等级:中级 普通读书笔记卡
10 第1章 整洁代码
13 张卡片
- 测试可访问性应先审视边界 理解等级:中级 普通读书笔记卡
- 类的大小应按责任理解 理解等级:中级 普通读书笔记卡
- 模块划分要降低理解的范围 理解等级:中级 普通读书笔记卡
- 内聚关注状态与行为的整体 理解等级:中级 普通读书笔记卡
- 局部变量升为字段会扩大生命周期 理解等级:中级 普通读书笔记卡
- 素数输出可分成三种变化 理解等级:中级 结构图卡
- 分页索引应区分边界与布局 理解等级:中级 普通读书笔记卡
- 奇数倍数追踪减少重复筛查 理解等级:中级 普通读书笔记卡
- 工具类静态状态仍然会共享 理解等级:中级 普通读书笔记卡
- 变动证据决定何时拆分责任 理解等级:中级 普通读书笔记卡
- 扩展点也有契约和组装成本 理解等级:中级 普通读书笔记卡
- 抽象价格源让估值条件可控 理解等级:中级 普通读书笔记卡
- 依赖抽象要对应稳定业务需要 理解等级:中级 普通读书笔记卡
11 第2章 有意义的命名
16 张卡片
- 构造策略应与运行职责分开 理解等级:中级 普通读书笔记卡
- 延迟创建需要失败和并发契约 理解等级:中级 普通读书笔记卡
- 工厂分离创建时机与细节 理解等级:中级 结构图卡
- 依赖注入把组装交给外部 理解等级:中级 普通读书笔记卡
- 注入方式不决定创建时机 理解等级:中级 普通读书笔记卡
- 基础设施侵入会扩大测试前提 理解等级:中级 普通读书笔记卡
- 横切关注面跨越领域边界 理解等级:中级 普通读书笔记卡
- 方面还要声明行为应用位置 理解等级:中级 普通读书笔记卡
- 动态代理将调用交给处理器 理解等级:中级 普通读书笔记卡
- 代理包装不自动提供事务一致性 理解等级:中级 普通读书笔记卡
- 对象注入不等于装饰器套接 理解等级:中级 普通读书笔记卡
- 声明映射仍然保留基础设施契约 理解等级:中级 普通读书笔记卡
- 架构演进依赖可替换的边界 理解等级:中级 普通读书笔记卡
- 可延迟决策应保留行动窗口 理解等级:中级 普通读书笔记卡
- 标准的价值要落到实际需要 理解等级:中级 普通读书笔记卡
- 领域语言缩短概念到实现的距离 理解等级:中级 普通读书笔记卡
12 第3章 函数
7 张卡片
- 测试反馈能暴露设计依赖 理解等级:中级 普通读书笔记卡
- 同一状态宜避免双份维护 理解等级:中级 普通读书笔记卡
- 抽取重复不会消除原有缺陷 理解等级:中级 普通读书笔记卡
- 模板方法固定步骤开放差异 理解等级:中级 结构图卡
- 模式名称要与真实角色相符 理解等级:中级 普通读书笔记卡
- 测试可作为行为实例文档 理解等级:中级 普通读书笔记卡
- 减少实体数量服从更高目标 理解等级:中级 普通读书笔记卡
13 第4章 注释
21 张卡片
- 并发分开任务目的与执行时机 理解等级:中级 普通读书笔记卡
- 复合自增可产生重复编号 理解等级:中级 普通读书笔记卡
- 共享状态的访问面应受控 理解等级:中级 普通读书笔记卡
- 数据副本减少共享仍需边界 理解等级:中级 普通读书笔记卡
- 请求局部引用未必指向独占对象 理解等级:中级 普通读书笔记卡
- 并发容器提供有边界的原子能力 理解等级:中级 普通读书笔记卡
- 显式可重入锁仍归线程所有 理解等级:中级 普通读书笔记卡
- 信号量用许可限制同时进入数 理解等级:中级 普通读书笔记卡
- 倒计时门闩协调完成条件 理解等级:中级 普通读书笔记卡
- 互斥与活性问题要分开判断 理解等级:中级 普通读书笔记卡
- 有界队列连接生产与消费速率 理解等级:中级 普通读书笔记卡
- 读写协调兼顾一致性与进度 理解等级:中级 普通读书笔记卡
- 多资源获取需要统一协调 理解等级:中级 普通读书笔记卡
- 多个同步方法不等于整段原子 理解等级:中级 普通读书笔记卡
- 同步范围应覆盖完整不变量 理解等级:中级 普通读书笔记卡
- 关闭协议必须唤醒等待者 理解等级:中级 普通读书笔记卡
- 偶发失败应保留为调查证据 理解等级:中级 普通读书笔记卡
- 并发测试宜分离业务与调度 理解等级:中级 普通读书笔记卡
- 调度多样性增加暴露机会 理解等级:中级 普通读书笔记卡
- 让步提示不释放监视器 理解等级:中级 普通读书笔记卡
- 调度扰动测试要可配置可追索 理解等级:中级 普通读书笔记卡
14 第5章 格式
25 张卡片
- 解析范式把标识映射到行为 理解等级:中级 普通读书笔记卡
- 输入校验顺序影响边界行为 理解等级:中级 普通读书笔记卡
- 共享迭代器把值消费交给类型 理解等级:中级 普通读书笔记卡
- 参数出现与默认值是不同事实 理解等级:中级 普通读书笔记卡
- 类型专用解析分开缺失与非法值 理解等级:中级 普通读书笔记卡
- 宽松取值可能掩盖调用类型错误 理解等级:中级 普通读书笔记卡
- 错误对象集中承载失败上下文 理解等级:中级 普通读书笔记卡
- 类型扩展仍需维护协调位置 理解等级:中级 普通读书笔记卡
- 失败状态与控制转移需要一致 理解等级:中级 普通读书笔记卡
- 类型维度的重复会扩散修改点 理解等级:中级 普通读书笔记卡
- 计数接口要说明统计的对象 理解等级:中级 普通读书笔记卡
- 设置结果不能只表示识别类型 理解等级:中级 普通读书笔记卡
- 替换表示时应先枚举契约触点 理解等级:中级 普通读书笔记卡
- 包装调用前的解引用仍会先失败 理解等级:中级 普通读书笔记卡
- 迁移中的集中状态只是过渡 理解等级:中级 普通读书笔记卡
- 统一返回类型会移动类型责任 理解等级:中级 普通读书笔记卡
- 双写迁移需保持同一对象身份 理解等级:中级 普通读书笔记卡
- 局部测试通过不代表契约已覆盖 理解等级:中级 普通读书笔记卡
- 错误上下文可按责任逐层补充 理解等级:中级 普通读书笔记卡
- 初步抽象要检查剩余职责 理解等级:中级 普通读书笔记卡
- 先分离错误分支再统一派发 理解等级:中级 普通读书笔记卡
- 统一签名应表达共同调用协议 理解等级:中级 普通读书笔记卡
- 新增类型要覆盖成功与失败 理解等级:中级 普通读书笔记卡
- 状态查询改抛异常会改变契约 理解等级:中级 普通读书笔记卡
- 文案归属可以是明确的折衷 理解等级:中级 普通读书笔记卡
15 第6章 对象和数据结构
8 张卡片
- 比较消息可压缩共同上下文 理解等级:中级 普通读书笔记卡
- 差异区间可以是空片段 理解等级:中级 普通读书笔记卡
- 偏移编码会增加边界推理成本 理解等级:中级 普通读书笔记卡
- 正面条件仍须准确表达责任 理解等级:中级 普通读书笔记卡
- 时序依赖可以由结构维护 理解等级:中级 普通读书笔记卡
- 改变索引约定要同步边界使用 理解等级:中级 普通读书笔记卡
- 空片段契约可消除无效分支 理解等级:中级 普通读书笔记卡
- 分析与合成可按职责分层 理解等级:中级 普通读书笔记卡
16 第7章 错误处理
17 张卡片
- 期望变化应与缺陷修复分开 理解等级:中级 普通读书笔记卡
- 严格前后星期要排除当天 理解等级:中级 普通读书笔记卡
- 最近星期可用循环偏移选择 理解等级:中级 普通读书笔记卡
- 枚举缩窄取值仍需边界转换 理解等级:中级 普通读书笔记卡
- 序列版本号需要兼容策略 理解等级:中级 普通读书笔记卡
- 实现能力可随创建策略提供 理解等级:中级 普通读书笔记卡
- 静态可替换工厂仍有全局状态 理解等级:中级 普通读书笔记卡
- 删除构造器要核对可见性契约 理解等级:中级 普通读书笔记卡
- 局部final表达不可重新赋值 理解等级:中级 普通读书笔记卡
- 行为宜靠近其解释的数据概念 理解等级:中级 普通读书笔记卡
- 闰年规则适用于约定历法 理解等级:中级 普通读书笔记卡
- 加月应先求目标再裁剪日期 理解等级:中级 普通读书笔记卡
- 返回新值的方法应显露结果用途 理解等级:中级 普通读书笔记卡
- 上移算法前须找隐含实现假设 理解等级:中级 普通读书笔记卡
- 区间成员资格可由枚举承载 理解等级:中级 普通读书笔记卡
- 仅测试调用不代表公开API无用 理解等级:中级 普通读书笔记卡
- 覆盖率变化需要看分母与内容 理解等级:中级 普通读书笔记卡
17 第8章 边界
22 张卡片
- 构建与测试应有清楚的统一入口 理解等级:中级 普通读书笔记卡
- 多语言混排要看认知边界 理解等级:中级 普通读书笔记卡
- 压制告警不等于修复原因 理解等级:中级 普通读书笔记卡
- 抽象能力不应要求实现撒谎 理解等级:中级 普通读书笔记卡
- 依赖方向影响组件独立部署 理解等级:中级 普通读书笔记卡
- 通用概念不宜绑在无关宿主 理解等级:中级 普通读书笔记卡
- 特性依恋要结合职责取舍 理解等级:中级 普通读书笔记卡
- 条件分支两侧须保持量纲一致 理解等级:中级 普通读书笔记卡
- 静态方法选择要看替换责任 理解等级:中级 普通读书笔记卡
- 解释性变量应命名中间角色 理解等级:中级 普通读书笔记卡
- 能力上限应向责任方查询 理解等级:中级 普通读书笔记卡
- 魔术值的问题是隐含意义 理解等级:中级 普通读书笔记卡
- 唯一性等假设应成为明确检查 理解等级:中级 普通读书笔记卡
- 整数金额仍需单位与舍入约定 理解等级:中级 普通读书笔记卡
- 结构约束可强化实现义务 理解等级:中级 普通读书笔记卡
- 通配导入不会消除实际类型依赖 理解等级:中级 普通读书笔记卡
- 常量访问不应伪装类型关系 理解等级:中级 结构图卡
- 引用方式整理不证明工资公式 理解等级:中级 普通读书笔记卡
- 计分过程要区分轮次与投球位置 理解等级:中级 普通读书笔记卡
- 忽略测试应显露未决需求 理解等级:中级 普通读书笔记卡
- 失败模式能指引进一步取样 理解等级:中级 普通读书笔记卡
- 覆盖探针帮助寻找未执行路径 理解等级:中级 普通读书笔记卡
18 第9章 单元测试
23 张卡片
- 性能时限应同时验证工作完成 理解等级:中级 普通读书笔记卡
- 调度策略可从请求处理分离 理解等级:中级 结构图卡
- 固定工作线程不限制积压任务 理解等级:中级 普通读书笔记卡
- 交错数量依赖简化执行模型 理解等级:中级 普通读书笔记卡
- 原子读写不等于复合动作原子 理解等级:中级 普通读书笔记卡
- 私有操作数栈仍可带共享引用 理解等级:中级 普通读书笔记卡
- Future结果等待放到汇合处 理解等级:中级 普通读书笔记卡
- 比较交换把条件与更新合为原子 理解等级:中级 普通读书笔记卡
- 原子条件插入须保护整个判断 理解等级:中级 普通读书笔记卡
- 取值与结束判断可合成原子入口 理解等级:中级 普通读书笔记卡
- 漏锁可破坏缓冲区状态不变量 理解等级:中级 问题卡
- 慢读取不宜占住任务分配锁 理解等级:中级 普通读书笔记卡
- 理想流水吞吐要声明资源假设 理解等级:中级 普通读书笔记卡
- 反向获取有限资源池可能死锁 理解等级:中级 问题卡
- 死锁分析要同时检查四个条件 理解等级:中级 普通读书笔记卡
- 移除互斥要匹配资源本质 理解等级:中级 普通读书笔记卡
- 失败释放重试仍有活性代价 理解等级:中级 普通读书笔记卡
- 协商释放不能当强制夺锁 理解等级:中级 普通读书笔记卡
- 统一资源顺序可消除等待环 理解等级:中级 普通读书笔记卡
- 找反例测试的绿灯有特殊含义 理解等级:中级 普通读书笔记卡
- ConTest扰动暴露竞争 理解等级:中级 延伸参考卡
- 停止标志不自动唤醒阻塞接收 理解等级:中级 普通读书笔记卡
- 消息内容与流帧格式需匹配 理解等级:中级 普通读书笔记卡
19 第10章 类
13 张卡片
- 日期值与时间点有不同契约 理解等级:中级 普通读书笔记卡
- final引用不会冻结格式符号 理解等级:中级 普通读书笔记卡
- 回退解析应重置失败状态 理解等级:中级 普通读书笔记卡
- 闰年累计必须说明包含端点 理解等级:中级 普通读书笔记卡
- 不可变承诺要说明状态范围 理解等级:中级 普通读书笔记卡
- 日期断言要覆盖所需完整结果 理解等级:中级 普通读书笔记卡
- 本地化测试需要声明语言环境 理解等级:中级 普通读书笔记卡
- 序列化回环不证明跨版本兼容 理解等级:中级 普通读书笔记卡
- 相同月份名不保证编号相同 理解等级:中级 普通读书笔记卡
- 往返测试不能替代外部语义判据 理解等级:中级 普通读书笔记卡
- 冗余表示需要同步不变量 理解等级:中级 普通读书笔记卡
- 克隆边界取决于对象图 理解等级:中级 普通读书笔记卡
- 无日期不应掩盖无效规则 理解等级:中级 普通读书笔记卡
00
8 张卡片
- 细节与架构共同影响维护 理解等级:中级 普通读书笔记卡
- 五常管理可映射代码纪律 理解等级:中级 普通读书笔记卡
- 易维护性要在设计时准备 理解等级:中级 普通读书笔记卡
- 局部修复也是持续设计 理解等级:中级 普通读书笔记卡
- 缩进相关不等于缺陷因果 理解等级:中级 普通读书笔记卡
- 代码也是设计的载体 理解等级:中级 普通读书笔记卡
- 如实暴露代码状态才能改进 理解等级:中级 普通读书笔记卡
- 学习规则要追踪具体决策 理解等级:中级 普通读书笔记卡
01
18 张卡片
- 自动化仍需明确执行语义 理解等级:中级 普通读书笔记卡
- 可运行不等于可持续维护 理解等级:中级 普通读书笔记卡
- 混乱会放大修改的理解负担 理解等级:中级 普通读书笔记卡
- 整体重写需追赶现有系统变化 理解等级:中级 普通读书笔记卡
- 风险沟通属于开发责任 理解等级:中级 普通读书笔记卡
- 辨认缺陷与安排变换不同 理解等级:中级 普通读书笔记卡
- 集中责任有助于表达意图 理解等级:中级 普通读书笔记卡
- 直接控制流让设计意图可读 理解等级:中级 普通读书笔记卡
- 可读与可增补是不同能力 理解等级:中级 普通读书笔记卡
- 测试为修改提供行为约束 理解等级:中级 普通读书笔记卡
- 少量明确接口降低依赖负担 理解等级:中级 普通读书笔记卡
- 简单设计规则有优先顺序 理解等级:中级 普通读书笔记卡
- 重复可能暴露未表达的概念 理解等级:中级 普通读书笔记卡
- 小型抽象隔离查找实现 理解等级:中级 普通读书笔记卡
- 接口应使下一步行为可预期 理解等级:中级 普通读书笔记卡
- 规则流派需要按约束检验 理解等级:中级 普通读书笔记卡
- 为读者降低修改前的理解成本 理解等级:中级 普通读书笔记卡
- 每次修改留下局部改善 理解等级:中级 普通读书笔记卡
02
23 张卡片
- 名称同时说明对象与单位 理解等级:中级 普通读书笔记卡
- 领域命名能显露筛选意图 理解等级:中级 普通读书笔记卡
- 行为接口可隐藏状态表示 理解等级:中级 普通读书笔记卡
- 名称不应暗示不存在的能力 理解等级:中级 普通读书笔记卡
- 视觉差异也影响名称辨别 理解等级:中级 普通读书笔记卡
- 不同名称应说明不同角色 理解等级:中级 普通读书笔记卡
- 可读出的名字便于协作讨论 理解等级:中级 普通读书笔记卡
- 可搜索性应匹配名称作用域 理解等级:中级 普通读书笔记卡
- 类型编码可能落后于真实类型 理解等级:中级 普通读书笔记卡
- 成员身份可由局部语境表达 理解等级:中级 普通读书笔记卡
- 公开接口名称优先表达角色 理解等级:中级 普通读书笔记卡
- 名字应减少额外的心智翻译 理解等级:中级 普通读书笔记卡
- 类名应显露对象承担的角色 理解等级:中级 普通读书笔记卡
- 方法名称应对应实际业务责任 理解等级:中级 普通读书笔记卡
- 命名工厂能说明构造参数含义 理解等级:中级 普通读书笔记卡
- 笑话名称会增加文化依赖 理解等级:中级 普通读书笔记卡
- 同一概念宜保持词汇一致 理解等级:中级 普通读书笔记卡
- 相同词不应掩盖不同操作 理解等级:中级 普通读书笔记卡
- 名称来源取决于概念所属 理解等级:中级 普通读书笔记卡
- 对象语境能组织相关字段 理解等级:中级 结构图卡
- 项目标签不必污染所有名称 理解等级:中级 普通读书笔记卡
- 精确限定优于无关的长前缀 理解等级:中级 普通读书笔记卡
- 重命名应验证引用边界 理解等级:中级 普通读书笔记卡
03
27 张卡片
- FitNesse用页面组织测试 理解等级:中级 延伸参考卡
- 抽取调用仍需核对行为边界 理解等级:中级 普通读书笔记卡
- 函数行数阈值只是经验 理解等级:中级 普通读书笔记卡
- 同层步骤应隐藏下一层实现 理解等级:中级 普通读书笔记卡
- 向下阅读使调用层次可追踪 理解等级:中级 普通读书笔记卡
- 单一职责关注变化理由 理解等级:中级 普通读书笔记卡
- 开闭原则围绕选定变化扩展 理解等级:中级 普通读书笔记卡
- 工厂可集中对象类型分派 理解等级:中级 结构图卡
- 命名困难可提示职责混合 理解等级:中级 普通读书笔记卡
- 参数数量不能独立衡量复杂度 理解等级:中级 普通读书笔记卡
- 一元调用要区分查询与转换 理解等级:中级 普通读书笔记卡
- 事件入口应显露状态改变 理解等级:中级 普通读书笔记卡
- 布尔开关可能混合两套动作 理解等级:中级 普通读书笔记卡
- 多个参数需要角色与顺序线索 理解等级:中级 普通读书笔记卡
- 浮点容限要对应比较目标 理解等级:中级 普通读书笔记卡
- 参数对象应表示共同概念 理解等级:中级 普通读书笔记卡
- 变长参数仍要说明元素角色 理解等级:中级 普通读书笔记卡
- 隐含副作用会产生时序依赖 理解等级:中级 问题卡
- 接口应让数据修改方向可见 理解等级:中级 普通读书笔记卡
- 查询与动作应有清楚的结果语义 理解等级:中级 普通读书笔记卡
- 异常可分开失败路径与主流程 理解等级:中级 普通读书笔记卡
- 错误处理边界也需要明确责任 理解等级:中级 普通读书笔记卡
- 共享错误表会扩大语义依赖 理解等级:中级 普通读书笔记卡
- 共享步骤应显式表达差异 理解等级:中级 普通读书笔记卡
- 提前返回也可保持局部清晰 理解等级:中级 普通读书笔记卡
- 先建立行为再迭代函数结构 理解等级:中级 普通读书笔记卡
- 调用级对象可收拢渲染上下文 理解等级:中级 结构图卡
04
24 张卡片
- 注释需要随所指代码共同维护 理解等级:中级 普通读书笔记卡
- 固定发布声明不等于功能注解 理解等级:中级 普通读书笔记卡
- 说明意图不等于证明方案正确 理解等级:中级 普通读书笔记卡
- 失败标记不能代替完成等待 理解等级:中级 问题卡
- 外部接口的约定可就地阐明 理解等级:中级 普通读书笔记卡
- 比较结果应先按符号解释 理解等级:中级 普通读书笔记卡
- 警示应保留危险条件与理由 理解等级:中级 普通读书笔记卡
- 共享格式器须明确同步边界 理解等级:中级 普通读书笔记卡
- TODO记录待办而非完成证据 理解等级:中级 普通读书笔记卡
- 注释可解释看似多余的操作 理解等级:中级 普通读书笔记卡
- 公共文档应补足调用者契约 理解等级:中级 普通读书笔记卡
- 注释不能凭空补出恢复行为 理解等级:中级 问题卡
- 注释须提供名称之外的信息 理解等级:中级 普通读书笔记卡
- 条件变化不会自动唤醒等待者 理解等级:中级 问题卡
- 变更历史宜保存在版本记录中 理解等级:中级 普通读书笔记卡
- 定位标记不能替代清楚结构 理解等级:中级 普通读书笔记卡
- 注释代码不应充当长期备份 理解等级:中级 普通读书笔记卡
- 文档格式要兼顾源码与生成物 理解等级:中级 普通读书笔记卡
- 说明应靠近事实的维护来源 理解等级:中级 普通读书笔记卡
- Base64把三字节映成四符号 理解等级:中级 普通读书笔记卡
- 注释应把常量与原因对应起来 理解等级:中级 普通读书笔记卡
- 筛法按小因子排除合数 理解等级:中级 普通读书笔记卡
- 空数组与空引用不是一回事 理解等级:中级 普通读书笔记卡
- 抽取函数不消除静态共享状态 理解等级:中级 结构图卡
全书概览
代码整洁之道
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实践计划。全书主线/跨章综合与实践入口已写整书笔记。轻量模式:未执行复核、审查及审查结果优化。
相关主题
从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。
暂无公开主题。