主题索引
测试有效性与验证手段
比较单元测试、变异、模糊测试、静态分析与故障注入各自能证明什么。
来源书籍
7/7
_workflow.md),不补写。_workflow.md v8 升级记录。类别:代码可读性与重构类
| 章节号 | 章节标题 | 状态 | 卡片数 |
|---|---|---|---|
| 5 | 程序员之旅 | done | 0 |
| 6 | 序 | done | 0 |
| 7 | 前言 | done | 0 |
| 9 | 关于本书 | done | 0 |
| 10 | 关于封面 | done | 0 |
| 11 | 第一部分 准备工作 | done | 0 |
| 12 | 第 1 章 软件质量和待解决问题 | done | 7 |
| 13 | 第 2 章 Reference的实现 | done | 8 |
| 14 | 第二部分 软件质量 | done | 0 |
| 15 | 第 3 章 速度的要求:时间效率 | done | 11 |
| 16 | 第 4 章 宝贵的内存:空间效率 | done | 13 |
| 17 | 第 5 章 有自我意识的代码:通过监控实现可靠性 | done | 15 |
| 18 | 第 6 章 别对我撒谎:通过测试保证可靠性 | done | 13 |
| 19 | 第 7 章 让代码说话:可读性 | done | 10 |
| 20 | 第 8 章 多个厨师一锅饭:线程安全 | done | 14 |
| 21 | 第 9 章 请重复利用:可复用性 | done | 15 |
| 22 | 附录 A 代码高尔夫:简洁性 | done | 2 |
| 23 | 附录 B 终极水容器类 | done | 1 |
总卡片数:109(原44张保留,新增65张)。
| 实践标题 | 实践方式 | 交付 | 执行 |
|---|---|---|---|
| 导入书名匹配契约审查 | 真实任务 | done:ideas/idea-001-cardbox导入命令的前置条件审查.md |
未执行 |
| 编号分配防御契约盘点 | 真实任务 | done:ideas/idea-002-编号分配器防御行为补测试.md |
未执行 |
| 水容器方案按负载比较 | 横向学习 | done:ideas/idea-003-水容器方案按负载比较.md |
未执行 |
实践候选筛选done:不凭书中算法推断本地项目有性能问题;并发与复用候选缺当前真实任务入口,不强行制造改动。水容器不全量重写,以已有表示及负载比较填首轮材料。资金案例仅为原书ATM说明性情境,未扩写为现实事故或实际干预。
| 维度 | 覆盖状态 | 关联卡片标题或未覆盖理由 |
|---|---|---|
| 命名与可读性原则 | 补充生成 | 原有卡片未覆盖”7.3.2 命名”一节,定向核实后补生成 [[约定命名胜过冗长命名]](ch07-006) |
| 函数/方法粒度与职责划分 | 已覆盖 | [[方法名代替注释]](提取方法收窄职责) |
| 注释与文档的取舍 | 已覆盖 | [[文档注释写契约]]、[[方法名代替注释]] |
| 契约式设计 | 已覆盖 | [[契约划清责任]]、[[前置只写可控]]、[[不变式守一致]]、[[公有前置常开]]、[[后置检查昂贵]] |
| 测试驱动的可靠性验证 | 已覆盖 | [[测试外置契约]]、[[输入领域建模]]、[[两种覆盖互补]]、[[可测试性三要素]]、[[注入也有成本]] |
| 重构手法与坏味道识别 | 已覆盖 | [[提取变量降负担]]、[[方法名代替注释]] |
| 复杂度分析与权衡 | 已覆盖 | [[大O看增长级]]、[[摊销看长期成本]]、[[空间优化降抽象]] 等第2–4章卡片 |
本书对应的”代码可读性与重构类”清单为本次新增注册(写入 category-checklists.md),供未来同类书籍复用。
本书以同一个水容器问题贯穿各质量属性,新建 4 个主题(质量取舍、时空效率、契约式设计、可读性),并把测试、并发、接口与模块化等内容并入已有主题。
| 卡片标题 | 结论 | 主题文件或原因 |
|---|---|---|
| 质量是多维取舍 | 已创建 | notes/_topics/software-quality-tradeoffs.md |
| 内外质量相连 | 已创建 | notes/_topics/software-quality-tradeoffs.md |
| 先满足当前需求 | 已创建 | notes/_topics/software-quality-tradeoffs.md、notes/_topics/simplicity-complexity.md |
| 隐式模型也合理 | 已创建 | notes/_topics/software-quality-tradeoffs.md |
| 面向接口声明 | 已复用 | notes/_topics/interface-design-dispatch.md |
| 图示辅助设计 | 已复用 | notes/_topics/modeling-purpose-notation.md |
| 大O看增长级 | 已创建 | notes/_topics/time-space-efficiency.md |
| 对象头有成本 | 已创建 | notes/_topics/time-space-efficiency.md、notes/_topics/builtin-data-structure-internals.md |
| 多方法无银弹 | 已创建 | notes/_topics/software-quality-tradeoffs.md |
| 负载可以转移 | 已创建 | notes/_topics/software-quality-tradeoffs.md |
| 并查集取平衡 | 已创建 | notes/_topics/time-space-efficiency.md |
| 摊销看长期成本 | 已创建 | notes/_topics/time-space-efficiency.md |
| 基准测试防幻觉 | 已创建 | notes/_topics/time-space-efficiency.md、notes/_topics/testing-effectiveness.md |
| 空间优化降抽象 | 已创建 | notes/_topics/time-space-efficiency.md |
| 懒初始化省空间 | 已创建 | notes/_topics/time-space-efficiency.md |
| 集合内存有价 | 已创建 | notes/_topics/time-space-efficiency.md、notes/_topics/builtin-data-structure-internals.md |
| 去对象化有代价 | 已创建 | notes/_topics/time-space-efficiency.md |
| 局部性影响速度 | 已创建 | notes/_topics/time-space-efficiency.md |
| 契约划清责任 | 已创建 | notes/_topics/design-by-contract.md |
| 前置只写可控 | 已创建 | notes/_topics/design-by-contract.md |
| 不变式守一致 | 已创建 | notes/_topics/design-by-contract.md |
| 公有前置常开 | 已创建 | notes/_topics/design-by-contract.md |
| 后置检查昂贵 | 已创建 | notes/_topics/design-by-contract.md |
| 测试外置契约 | 已创建 | notes/_topics/design-by-contract.md、notes/_topics/testing-effectiveness.md |
| 输入领域建模 | 已复用 | notes/_topics/testing-effectiveness.md |
| 两种覆盖互补 | 已复用 | notes/_topics/testing-effectiveness.md |
| 可测试性三要素 | 已复用 | notes/_topics/testing-effectiveness.md |
| 注入也有成本 | 已复用 | notes/_topics/testing-effectiveness.md |
| 可读性省接手 | 已创建 | notes/_topics/code-readability.md |
| 选择具体循环 | 已创建 | notes/_topics/code-readability.md |
| 提取变量降负担 | 已创建 | notes/_topics/code-readability.md |
| 文档注释写契约 | 已创建 | notes/_topics/code-readability.md |
| 方法名代替注释 | 已创建 | notes/_topics/code-readability.md |
| 约定命名胜过冗长命名 | 已创建 | notes/_topics/code-readability.md |
| 先定并发策略 | 已复用 | notes/_topics/concurrency-tasks-sync.md |
| 锁顺序致死锁 | 已复用 | notes/_topics/concurrency-tasks-sync.md |
| 全局锁换简单 | 已复用 | notes/_topics/concurrency-tasks-sync.md |
| 有序锁破循环 | 已复用 | notes/_topics/concurrency-tasks-sync.md |
| 不可变避同步 | 已复用 | notes/_topics/concurrency-tasks-sync.md |
| 复用先划边界 | 已复用 | notes/_topics/modularity-information-hiding.md |
| 二元方法难表达 | 已复用 | notes/_topics/interface-design-dispatch.md |
| 属性拆成四步 | 已复用 | notes/_topics/modularity-information-hiding.md |
| 擦除限制泛型 | 已复用 | notes/_topics/correct-by-construction.md |
| 框架不是万能 | 已复用 | notes/_topics/simplicity-complexity.md |
执行模式:light 建档进度:阶段二已完成 实践候选筛选:done 本次执行版本:book-workflow v4 / book-notes v23;历史版本保留。
整书笔记按18个实质正文项讲解,登记109个唯一primary及每卡实际原文出处。137单元全文阅读及候选去向见覆盖记录;缓存与当前EPUB全文件字节一致。轻量模式未执行笔记复核、独立审查及审查结果优化。新增卡片与历史卡路径分别保留,未批量回填历史学习元数据。
| spine项 | 排除理由 |
|---|---|
| 1 | 封面图片 |
| 2 | 阅读平台宣传页 |
| 3 | 版权信息,已用于核实身份与ISBN |
| 4 | 授权声明 |
| 8 | 致谢名单,完整读过但未展开独立技术机制 |
| 24 | 类与包索引,不含新论证 |
| 25 | 作者简介 |
| 26 | 社区联系方式与推广信息 |
| 术语名 | 出现章节 | 一句话语境 |
|---|---|---|
| ISO/IEC 9126与25010 | 第1章 | 质量分类的标准背景,不把书中年代信息当作当前标准状态。 |
| FURPS | 第1章 | 惠普质量模型分组示例,正文仅简述名称含义。 |
| Java Card | 第4章 | 受限环境使用小尺寸数值类型的例子,未展开平台机制。 |
| 阿克曼函数与逆函数 | 第3章 | 并查集摊销上界的函数背景,未展开严格构造和复杂度证明。 |
| 线性时间选择算法 | 第3章 | 中位数实现的延伸检索方向,原书明确不展开算法。 |
| 深度学习计算图 | 第3章 | 说明时间效率的应用场景,未展开训练或图执行机制。 |
| JNI | 第1章 | 性能敏感局部采用低层语言的互操作入口,未展开接口机制。 |
| realloc | 第3章脚注 | 与数组扩容比较的C库函数提名,未展开真实分配器行为。 |
| MVC的Web变体 | 第9章 | 仅提及不同场景与变体,未比较各框架的实际通信协议。 |
| JMM | 第8章 | 作为Java并发规则基础被提及,本书只讨论相关局部可见性与同步,不展开完整模型。 |
| RESTful服务 | 第6章 | 工资服务测试的现实场景,未展开HTTP或REST机制。 |
| 序列化与反序列化 | 第6章 | 文件输入使测试更难控制的例子,未展开编码格式。 |
| How to Write Doc Comments for the Javadoc Tool | 第7章7.11 | 官方文档风格指南标题,纯推荐未展开内容;文档不冒标为书或论文。 |
| Anarchy Golf | 附录A | 代码高尔夫竞赛站点,作为继续浏览入口,未展开算法。 |
| Code Golf on StackExchange | 附录A | 代码高尔夫竞赛与讨论站点,未展开具体解法。 |
| The International Obfuscated C Code Contest | 附录A | 晦涩C程序竞赛,说明特殊编码目标,未展开其实现。 |
| .kkrieger | 附录A | 96KB游戏作为极端压缩编码示例提名,未讲解其生成机制。 |
| 标题 | 类型(书/论文/框架/源码项目) | 出现章节 | 一句话语境 |
|---|---|---|---|
| 风格练习 | 书 | 前言 | Raymond Queneau用同一故事的不同写法启发本书多实现对照。 |
| 编程风格:好代码的逻辑 | 书 | 前言 | Cristina Videira Lopes用多种约束风格解决同一任务,作为延伸阅读。 |
| 99 Ways to Tell a Story: Exercises in Style | 书 | 前言 | Matt Madden的同一故事多种漫画版本,延伸了解风格练习。 |
| 代码大全 | 书 | 第1章、第7章 | 质量关系与编码实践的延伸阅读。 |
| 代码质量 | 书 | 第1章 | Diomidis Spinellis以真实项目代码讨论质量属性。 |
| 软件质量工程的度量与模型 | 书 | 第1章 | Stephen H. Kan对软件指标及统计评估的系统介绍。 |
| 敏捷度量实战:如何度量并改进团队绩效 | 书 | 第1章 | Christopher W. H. Davis讨论质量与评估指标。 |
| Java核心技术 | 书 | 序、第2章 | Cay S. Horstmann的Java语言和API教学参考。 |
| 写给大忙人看的Java核心技术 | 书 | 序 | 作序者的其他著作,仅书名推荐。 |
| 快学Scala | 书 | 序 | 作序者的其他著作,仅书名推荐。 |
| Java Precisely, Third Edition | 书 | 第2章 | Peter Sestoft的语言与部分API参考指南。 |
| 算法导论 | 书 | 第2章、第3章 | 算法复杂度、并查集与摊销分析的延伸阅读。 |
| UML精粹:标准对象建模语言简明指南 | 书 | 第2章 | Martin Fowler的UML表示法参考。 |
| UML和模式应用 | 书 | 第2章 | Craig Larman的面向对象分析与设计参考。 |
| 算法设计 | 书 | 第3章 | J. Kleinberg与E. Tardos的算法及摊销分析参考;课件推荐随该主题记录,不冒称已阅读。 |
| Java性能权威指南 | 书 | 第3章、第4章 | Scott Oaks讨论虚拟机调优、内存分析与工具。 |
| Making Embedded Systems | 书 | 第4章 | E. White的Doing More with Less章节作为受限内存优化参考。 |
| Java解惑 | 书 | 第4章 | Joshua Bloch与Neal Gafter的语言行为谜题参考。 |
| Effective Java | 书 | 第3章至第9章 | 异常、工厂、复制、不可变性及API设计等条目的延伸参考。 |
| 面向对象软件构造 | 书 | 第5章 | Bertrand Meyer介绍契约式设计与Eiffel。 |
| Handbook of Floating-Point Arithmetic | 书 | 第5章 | J.-M. Muller等对浮点计算的深入参考。 |
| What Every Computer Scientist Should Know About Floating-Point Arithmetic | 论文 | 第5章 | David Goldberg发表于ACM Computing Surveys的浮点计算文章。 |
| 软件测试的艺术 | 书 | 第6章 | G. J. Myers、C. Sandler与T. Badgett的测试和验证参考。 |
| 有效的单元测试 | 书 | 第6章 | L. Koskela的测试实践及测试坏味道目录。 |
| 测试驱动的面向对象软件开发 | 书 | 第6章 | S. Freeman与N. Pryce通过实例讨论测试驱动开发。 |
| 软件测试基础 | 书 | 第6章 | P. Ammann与J. Offutt的测试技术教材。 |
| 代码整洁之道 | 书 | 第7章 | R. C. Martin的编码风格参考。 |
| 架构整洁之道 | 书 | 第7章 | 代码整洁之道后续阅读,面向更高层次架构。 |
| 编程格调 | 书 | 第7章 | Brian W. Kernighan与P. J. Plauger的可读性格言来源。 |
| 程序设计实践 | 书 | 第7章 | Kernighan与R. Pike后续讨论编程风格。 |
| 重构:改善既有代码的设计 | 书 | 第7章 | Martin Fowler整理有名称的重构技术。 |
| Literate Programming | 书 | 第7章 | 高德纳将编程与文学表达相联系的论文集。 |
| Java并发编程实践 | 书 | 第4章、第8章 | B. Goetz等的并发与安全初始化参考;书内另有实战译名写法。 |
| Java实战 | 书 | 第8章、第9章 | R.-G. Urma、M. Fusco与A. Mycroft讨论数据流及并行计算。 |
| Wait-Free Parallel Algorithms for the Union-Find Problem | 论文 | 第8章 | R. J. Anderson与H. Woll的无等待并查集实现参考。 |
| Purely Functional Data Structures | 书 | 第8章 | Chris Okasaki对持久化数据结构的深入研究。 |
| Java Generics and Collections | 书 | 第9章 | M. Naftalin与P. Wadler讨论Java泛型和集合。 |
| 软件框架设计的艺术 | 书 | 第9章 | J. Tulach对可复用代码与API设计的讨论。 |
| 深入理解C# | 书 | 第9章 | J. Skeet对语言演进及泛型实现的比较。 |
| exercisesinstyle | 源码项目 | 关于本书、各正文章 | 原书按章组织示例的mfaella/exercisesinstyle代码库;本轮读取EPUB内代码,未声称拉取仓库。 |
| JMock | 框架 | 第6章扩展阅读 | 仅介绍测试驱动开发参考书作者来自该库,未展开机制。 |
| Mockito与Powermock | 框架 | 第6章 | 作为自动替换测试依赖的库举例;隔离概念已保留在相关卡片。 |
| PCollections与Cyclops | 框架 | 第8章 | 持久化集合库举例;结构共享机制保留在“持久化结构保留历史版本”。 |
| Apache Commons | 源码项目 | 第5章练习 | 最大公约数示例节选自Fraction类,未展开整个项目。 |
| BigRational | 源码项目 | 第9章练习 | Robert Sedgewick与Kevin Wayne的不可变任意精度有理数实现作为示例。 |
| 问题标题 | 问题卡 | 解决方案卡(如有) | 出现章节 | 一句话说明 |
|---|---|---|---|---|
| 漏查余额允许超额提现 | [[漏查余额允许超额提现]] | [[提现前置校验须常开]] | 第5章5.6⁄5.1.4 | 原书ATM说明性情境,限前置校验;不补造并发方案或现实事故。 |
本次执行版本:book-workflow v4 / book-notes v24;显式以 --mode light 恢复。首次历史Skill版本记录保留,缺失版本不补造。
原书100个ZIP文件与缓存逐字节一致,18个实质正文项、137个连续阅读单元及全部115份内容文件与V23放行快照一致,复用109张知识卡、3张实践计划(2真实任务、1横向学习)及整书笔记。本轮新增0张,不重做有效全文阅读、不批量回填历史学习元数据。覆盖字符范围依旧使用HTMLParser保留inline原始拼接并在块结束分隔、实体解码与空白归一,与历史提取文本逐字相同。轻量模式:未执行复核、审查及审查结果优化;实际实践本轮未执行。导入、归档和最终验收见 _workflow.md,证据 .local/runs/p3-160-20261113/。
从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。
主题索引
比较单元测试、变异、模糊测试、静态分析与故障注入各自能证明什么。
主题索引
比较渐近复杂度、摊销分析、基准测试以及以抽象换空间、局部性等时间与空间效率的权衡。
主题索引
比较建模语言作为草稿、蓝图或编程语言的不同用途,以及表示法规则、元模型与版本演化的边界。
主题索引
比较以函数、闭包、包或服务划定模块边界并隐藏实现细节的方法。
主题索引
线程的创建、状态、join/sleep/中断与收束,任务抽象为什么高于线程,线程池与 ForkJoin 的并行度与工作窃取,守护线程、ThreadLocal 与线程私有栈在什么条件下成立,以及并发结构怎样划分执行与状态;Actor/角色把状态隔离到单一线程、用 Inbox 串行收消息,是这条线的另一种解法。
主题索引
比较内部与外部质量、多准则权衡以及“先满足当前需求”在不同质量目标之间的取舍方法。
主题索引
互斥锁与读写锁的适用比例、信号量与 CountDownLatch 的语义差别、条件等待为什么必须持锁并循环复查、锁顺序与可重入导致的死锁,以及粗粒度锁换简单性与细粒度锁换并发的代价。
主题索引
比较字符串、数组、切片、哈希表等内置结构的内存布局、扩容与复制代价。
主题索引
比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。
主题索引
比较接口粒度、隐式/显式实现、接口值表示与动态分派的取舍。
主题索引
比较命名、注释、变量提取与结构选择等降低阅读负担、让代码表达意图的做法。
主题索引
原子不等于易变、volatile 不等于互斥,读改写为什么必须整体原子,竞态与数据争用的判定,内存屏障与顺序一致,双重检查锁与懒加载的发布问题,以及 Race 检测只覆盖运行路径的局限。
主题索引
比较借助类型系统、安全库、编译器与语言选择把错误挡在编码阶段的方法。
主题索引
比较前置条件、后置条件、不变式在划分调用方与实现方责任上的作用,以及检查开销和与测试的分工。