从零到交付的阅读顺序

这篇文章不是再讲一个新的知识点，而是把当前博客已经写完的三季内容，整理成三条可执行的阅读路径。

如果你第一次进入这个站点，最常见的问题不是“有没有文章”，而是：

我应该先看哪一组。

路径 A：第一次系统接触增量源生成器

如果你还没有完整走通过一个可维护的增量源生成器，最稳的读法就是：

1. 先从 什么是增量源生成器 开始，先把心智模型立住。
2. 再进入 从零实现增量源生成器，按章节顺序从头读到尾。
3. 第一季里不要跳过项目结构、目标发现、类型建模、渲染、诊断、测试和调试这几块，它们是后面所有工程化讨论的基础。
4. 第一季读完以后，再进入 附加文件与配置生成。

这一条路径的核心原则只有一个：

先把“源码输入主线”跑通，再去看配置输入、模板和交付。

路径 B：已经懂基础，准备做 AdditionalFiles 工程化

如果你已经知道 Roslyn 增量管道怎么搭，只是想快速进入 AdditionalFiles、MSBuild 元数据和配置系统这一层，可以按下面读：

1. 先补第一季的 6 篇关键文： 项目结构、 目标发现、 类型建模、 首个生成器、 诊断契约、 测试策略。
2. 再完整进入 附加文件与配置生成。
3. 第二季里最值得重点读的是： 为什么 AdditionalFiles 才是第二阶段真正的开始、 文件元数据来自 MSBuild 而不是 JSON、 真正难的是合并，不是读取、 合并，才是配置开始脱离单文件的地方、 显式文件发现打破的是文件名锁定。

这条路径适合已经能写出一个最小生成器，但还没把输入系统扩展到工程级的人。

路径 C：准备复制模板、发包和团队落地

如果你的目标不是“学习一个样例”，而是“准备把这套能力带进团队”，那就不要只看第一季和第二季的技术细节。

更稳的读法是：

1. 先补最少必要的基础： 什么是增量源生成器、 目标发现、 类型建模、 测试策略。
2. 再补第二季的 4 篇工程化关键文： 全局默认值会改变输出边界、 真正难的是合并，不是读取、 合并，才是配置开始脱离单文件的地方、 显式文件发现打破的是文件名锁定。
3. 最后完整进入 模板、工程化与落地。

第三季建议重点按下面顺序读：

1. 模板不是多余脚手架，而是长期成本控制器
2. simple 模板适合验证，不适合长期还债
3. standard 模板真正值钱的地方，是改动落点清晰
4. enterprise 模板不是“文件最多”，而是“交付闭环最完整”
5. 从模板复制到新仓库时，最容易失败的是改名与包消费链路
6. ProjectReference 跑通，不等于 PackageReference 可交付
7. 分层配置不该等到第二个仓库才设计
8. 测试基座应该早于复杂功能扩展
9. sample 负责证明模板活着，tests 才负责证明它没撒谎
10. 交付脚本应该是模板契约的一部分，而不是口头流程
11. 发布检查清单应该写进模板，而不是留在人的记忆里

如果你只打算花一小时

那就不要试图横扫全站。

更有效的做法是：

• 学基础：读第一季入口和前 5 篇
• 学配置：读第二季入口加“读取、合并、显式发现”三组文章
• 学交付：读第三季入口加“模板选型、改名、PackageReference、测试、发布清单”

一句话结论

这套博客现在已经不是单线教程，而是三条主线并行的知识结构。最稳的方式不是按时间乱跳，而是先选你当前所处阶段，再按对应路径顺序读。