从零实现增量源生成器 · 第 3 / 17 篇

项目结构与协作关系,要用生成器视角去看

看教程仓库时,不要只看文件树;更重要的是理解生成器项目、示例项目和测试项目之间怎样构成一条完整反馈回路。

如果只把仓库结构看成一棵目录树,很容易忽略真正重要的东西:反馈回路。

对生成器项目来说,真正的最小闭环应该是:

  • 生成器代码定义规则
  • 示例项目触发这些规则
  • 测试工程把规则稳定下来

为什么这个视角重要

因为生成器很少单独存在。它总是同时面对两类压力:

  • 来自消费方的使用压力
  • 来自维护方的回归压力

如果你的结构不能同时承接这两类压力,项目就会慢慢滑向“能演示,但不好维护”。

教程仓库最值得学的,不只是代码

很多人阅读这类仓库时只盯着 Generator.cs,其实更应该先理解协作关系。因为结构本身已经决定了后面哪些测试容易写、哪些错误容易复现、哪些能力适合继续扩展。

先把协作关系看清,再去读 API 细节,节奏会更稳。

教程导航

继续阅读

当前文章已经挂到教程顺序中,建议按相邻章节继续。

上一篇 项目拆开以后,源生成器工程才开始稳定 生成器、示例程序和测试工程必须拆开;只有这样,引用关系、调试入口和回归验证才会清晰。 下一篇 第一版 GenerateToString 生成器,先把主链路跑通 第一版生成器不求复杂,只求把入口、发现、诊断和输出这条最小闭环跑通。
查看系列目录 查看全部文章

标签

分类