参考文献

把书中经验主张追溯到研究、案例和延伸阅读，区分原始证据、作者综合与当前验证。

学习目标

  • 能把一个目录主张拆成引用坐标、原始证据、适用边界和当前复核
  • 能区分来源支持的事实、作者综合的推断与本项目需要重新验证的实践
  • 能在证据缺口、版本漂移或边界失效时暂停结论，并留下可重建的证据包

参考文献

本页依据 David Thomas、Andrew Hunt《程序员修炼之道：通向务实的最高境界（第2版·20周年版）》，云风译，电子工业出版社，2020 年 4 月，ISBN 9787121384356 的公开中文目录，独立重构 参考文献。正文、代码、图示、实验和练习都是本课程重新设计的教学材料，不复制原书正文、插图或答案。

参考文献不是把链接堆在页面末尾，而是回答一个可复核的问题：某个主张由什么来源支持，来源覆盖到哪里，哪些部分只是作者综合，迁移到当前项目后还缺什么验证。目录、出版信息和官方页面能确定范围，却不能自动证明每个工程结论在今天仍然成立。

三个会让引用链失真的陷阱

五个词把引用变成证据链

<Term def="记录主张对应的书目、章节、标题、版本或公开页面位置，使另一个人能回到同一处。">引用坐标</Term>不是笼统的“见参考资料”，而是能让复核者重新定位的坐标。坐标不完整时，来源只能算线索。

<Term def="直接描述对象、版本和观察结果的材料，而不是对材料的再次概括。">原始证据</Term>可以是官方规范、实验记录、版本页面或可重放的日志。它必须说明观察到了什么，也说明没有观察到什么。

<Term def="证据可以支持的时间、环境、对象、团队和风险范围；范围外的应用需要重新验证。">适用边界</Term>防止一条历史经验被包装成普遍定律。边界应该包括版本、输入、责任人和失效条件。

<Term def="由第二来源、独立复现实验或不同记录检查同一主张，寻找版本漂移和解释偏差。">交叉核对</Term>不是收集更多链接，而是比较来源之间是否真的谈论同一个对象。

<Term def="不依赖原作者的记忆、点击顺序或期待答案，由另一名复核者重建结论。">独立复核</Term>要求提供冻结输入、验收命题、边界和失败日志；只有最终结论而没有过程，不能算可复核证据。

五个词形成一条责任链：先写目录主张，再给出引用坐标，提取原始证据，声明适用边界，最后交给独立复核。链条中任一节点缺失，结论都应停在缺口处，而不是跳到“已验证”。

证据链：链接只有接上边界才支持结论每一站都记录输入、首差、责任人和下一步复核1主张我要说什么已留证据2定位来源在哪里已留证据3证据观察到什么已留证据4边界何时不适用当前边界点5复核谁能重建待复核证据缺口出现时暂停，不把来源数量当成结论强度
专属图示：主张只有经过定位、证据和边界，才交给独立复核。

从目录主张到当前复核

目录主张

公开目录可以确认单元标题、顺序和范围。它是课程的范围依据，不等同于原书正文、作者论证或当前项目的结果。先写“我要验证的具体句子”，避免让标题承担超出来源能力的含义。

引用定位与原始证据

为主张记录 ISBN、版次、章节标题、公开页面和获取日期；能提供页码或稳定锚点时再补充。随后标注证据等级：目录事实、官方规范、实验观察、作者综合和待复核假设不能混为一谈。

适用边界与当前复核

把时间、工具版本、团队规模、数据敏感性、发布频率和监管约束写进边界。当前项目要重新运行代表性样本；自动化检查通过，只能证明它声明覆盖的分支，不会自动替代语义复核。

证据合同

type EvidenceClaim = {
  claim: string;
  citation: string;
  sourceKind: "catalog" | "official" | "experiment" | "synthesis";
  boundary: string[];
  crossCheck: string;
  reviewer: string;
  decision: "accept" | "narrow" | "pause";
};
 
function canPublish(claim: EvidenceClaim) {
  return (
    claim.claim.length > 0 &&
    claim.citation.length > 0 &&
    claim.boundary.length > 0 &&
    claim.crossCheck.length > 0 &&
    claim.decision !== "pause"
  );
}

这个合同不把证据压成一个分数。它强制记录主张、坐标、来源类型、边界、交叉核对和复核人；如果主张无法定位、超出边界或仍需暂停，就不能用“有参考文献”掩盖缺口。

四步复核流程

分步1 / 4

1. 写出主张和范围

把一个模糊标题改写成可判定的句子，注明对象、预期结果、版本和不在范围内的部分。目录只负责确定课程边界，不替代主张本身。

Interactive lab

选择证据样本，定位首个变化

需缩小

输入

第二来源使用不同版本，结果只在原环境成立。

首个变化

适用边界先发生变化，不能推广到当前环境。

裁决动作

缩小主张，补当前实验后再决定。

先定位证据缺口，再选择接受、缩小或暂停；不要用来源数量掩盖无法重建的过程。

正常、边界与单一故障证据

证据矩阵：看首个缺口，而不是看最后一张截图正常样本看闭合，边界样本看缩小，故障样本看暂停与恢复观察项正常边界故障版本已冻结发生漂移未记录坐标可定位仅有摘要链接失效边界已声明接近阈值被省略复核可重建需缩小无法重放任何一列不能重建，就把结论降级为线索或暂停
专属图示：同一条证据链在正常、边界和单一故障下的第一处差异。
样本只改变的变量预期判定必存证据
正常版本、坐标、原始证据和边界完整主张可定位，复核者能重建来源、坐标、输入和复核记录
边界版本、环境或证据等级恰好越过阈值缩小结论或暂停，不假装普遍有效阈值、冲突、未覆盖范围
单一故障一个坐标、来源或交叉核对失效在首个证据缺口停下并恢复首差、错误上下文和修复

最小证据包与反例

最小证据包包含主张、ISBN 与目录坐标、来源版本、获取日期、输入和代码哈希、工具版本、边界、观察日志、输出哈希、用户或系统结果、复核人、决定和恢复动作。截图、覆盖率或格式化结果只能辅助定位，不能单独证明掌握。

反例不是“我不同意”。它必须在相同前提下产生相反结果，或指出前提在目标环境并不成立。发现反例后，缩小适用范围、更新模型并重放旧样本；不能删除失败记录来保持主张永远正确。

术语表

名词解释

本章出现的专业名词，用大白话再讲一遍。

引用坐标

能让复核者回到同一书目、章节、标题、版本或公开页面位置的记录。

原始证据

直接描述对象、版本和观察结果的材料，而不是再次概括。

适用边界

证据可以支持的时间、环境、对象、团队和风险范围。

交叉核对

由第二来源或独立复现实验检查同一主张，寻找漂移和偏差。

独立复核

由另一名复核者在冻结输入和边界下重建结论。

练习

练习

问题 1： 你要引用一句“某实践能降低缺陷”，但手头只有目录标题和一篇未注明版本的博客。如何处理？

问题 2： 一个 2020 年的工具建议迁移到今天的 AI 辅助开发流程。你要补充哪些边界？

问题 3： 独立复核者无法根据你的资料重建结论，但最终截图看起来正确。你会如何决定？

资料与写作方式声明

本章以程序员修炼之道的权威目录界定学习范围，并结合正文列出的技术资料独立重写；不宣称复现原书正文，也不沿用原作表述。

原作版权归作者与出版社所有；本站原创教学结构与表述仅供学习交流。

本单元回顾

参考文献的价值不在于链接数量，而在于主张、引用坐标、原始证据、适用边界和独立复核可以互相接上。目录能确定范围，实验能验证当前行为，交叉核对能暴露漂移；证据不足时，暂停或缩小结论本身就是专业的结果。

前后导航

复习本章（6 题）

讨论

评论区加载中…