模板、工程化与落地 · 第 3 / 11 篇

standard 模板真正值钱的地方,是改动落点清晰

standard 模板不是 simple 的加厚版,而是大多数正式项目最该使用的默认骨架,因为每类改动都有明确落点。

很多人看 standard 模板时,会先数文件数量。

这其实抓错重点了。

standard 最值钱的地方,从来不是“文件适中”,而是你一旦开始维护它,就知道每类改动该落到哪里。

为什么多数正式项目都该从 standard 开始

真实项目最怕的,不是结构稍微多一点,而是结构没有边界。

standard 解决的正是这个问题:

  • 入口只做装配
  • Pipeline 负责发现与校验
  • Models 负责收口渲染真正依赖的数据
  • Rendering 负责最终输出
  • Diagnostics 负责编号和文案

这套拆分看上去朴素,但它决定了后面每次改需求时的清晰度。

最常见的一类维护动作

你以后最常做的事情,往往不是“重写整个生成器”,而是:

  • 多取一个字段
  • 多报一个错误
  • 多生成一段代码

standard 里,这些动作的落点基本是稳定的:

  • 字段扩展,先改 Models
  • 数据获取,去改 Pipeline
  • 输出变化,去改 Rendering
  • 契约错误,去改 Diagnostics

这种“改一类东西,就去一类位置”的稳定感,才是 standard 的核心价值。

它为什么不是缩水版 enterprise

有人会把 standard 理解成“暂时没补全的 enterprise”。

这个理解并不准确。

standard 不是半成品,它本来就是多数生成器项目的主力起点。

因为大多数项目在早期并不需要:

  • AdditionalFiles
  • 多配置文件合并
  • analyzer + generator 双项目
  • 打包与 package consumer 验证

这时候直接上 enterprise,承担的是结构成本,而不是业务收益。

standard 最重要的工程收益

它真正提供的是一种“局部修改不会牵一发而动全身”的状态。

这对生成器项目很关键。

因为生成器一旦进入长期维护期,最怕的不是复杂,而是每次小改都得重新读一遍整条链路。

一句话结论

standard 模板最重要的价值,不是文件比 simple 多,而是每类改动都有固定落点,这会直接决定项目能不能长期稳定维护。

教程导航

继续阅读

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

上一篇 simple 模板适合验证,不适合长期还债 simple 模板最有价值的地方是快速确认 Roslyn 接线和生成闭环,而不是承载你后面所有工程复杂度。 下一篇 enterprise 模板不是“文件最多”,而是“交付闭环最完整” enterprise 模板真正贵的不是复杂度本身,而是它把声明诊断、配置契约、测试和 NuGet 消费链路一起闭环了。
查看系列目录 查看全部文章

标签

分类