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

simple 模板适合验证,不适合长期还债

simple 模板最有价值的地方是快速确认 Roslyn 接线和生成闭环,而不是承载你后面所有工程复杂度。

simple 模板最容易被两种人误用:

  • 一种人觉得它太小,所以看不上
  • 另一种人觉得它已经能跑,于是一直往里堆

这两种都不稳。

simple 真正负责什么

simple 最适合回答的是三个问题:

  • Analyzer 引用方式有没有接对
  • 特性发现和最小 partial 校验有没有跑通
  • 第一份生成代码能不能被 sample 稳定调用

如果你现在只是想验证“这条生成器路线值不值得做”,simple 几乎就是成本最低的起点。

为什么它适合第一天,不适合第六周

因为 simple 的价值建立在“所有东西都足够近”。

入口、发现、校验和渲染放得很近,所以你第一次读几乎没有成本。

但当需求开始扩张以后,这个优点会反过来变成问题:

  • 入口类越来越长
  • 诊断开始和发现逻辑缠在一起
  • 渲染规则越来越多
  • 新人读代码时很难判断哪块是入口,哪块是业务规则

也就是说,simple 很擅长帮你确认方向,却不擅长帮你长期还债。

最容易出现的错误升级路径

很多项目一开始只想做一个最小样例,于是从 simple 起步。

这没有问题。

问题出在后来已经出现下面这些信号时,仍然不升级:

  • 一个文件里已经同时维护发现、诊断和渲染
  • 新增字段时需要在同一个大文件里来回跳
  • 你已经明确这个项目会进入正式仓库

这个阶段如果还坚持继续堆,后面每多一个需求,都在给未来加利息。

用 simple 的正确姿势

更稳的做法其实很简单:

  • simple 当成路线验证器
  • 把 sample 当成最小活体验证
  • 一旦确认方向成立,就尽快升级到 standard

这样你既拿到了最快的起步速度,也没有把后续结构债务一起收进来。

一句话结论

simple 模板最适合验证生成器路线是否成立;一旦项目进入正式维护阶段,它就应该尽快把位置让给更稳定的骨架。

教程导航

继续阅读

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

上一篇 模板不是多余脚手架,而是长期成本控制器 真正有价值的模板,不是在第一天帮你少敲几行代码,而是在后面每次扩字段、补诊断、接配置和交付时持续压低成本。 下一篇 standard 模板真正值钱的地方,是改动落点清晰 standard 模板不是 simple 的加厚版,而是大多数正式项目最该使用的默认骨架,因为每类改动都有明确落点。
查看系列目录 查看全部文章

标签

分类