模板、工程化与落地 · 第 2 / 11 篇
simple 模板适合验证,不适合长期还债
simple 模板最有价值的地方是快速确认 Roslyn 接线和生成闭环,而不是承载你后面所有工程复杂度。
simple 模板最容易被两种人误用:
- 一种人觉得它太小,所以看不上
- 另一种人觉得它已经能跑,于是一直往里堆
这两种都不稳。
simple 真正负责什么
simple 最适合回答的是三个问题:
Analyzer引用方式有没有接对- 特性发现和最小
partial校验有没有跑通 - 第一份生成代码能不能被 sample 稳定调用
如果你现在只是想验证“这条生成器路线值不值得做”,simple 几乎就是成本最低的起点。
为什么它适合第一天,不适合第六周
因为 simple 的价值建立在“所有东西都足够近”。
入口、发现、校验和渲染放得很近,所以你第一次读几乎没有成本。
但当需求开始扩张以后,这个优点会反过来变成问题:
- 入口类越来越长
- 诊断开始和发现逻辑缠在一起
- 渲染规则越来越多
- 新人读代码时很难判断哪块是入口,哪块是业务规则
也就是说,simple 很擅长帮你确认方向,却不擅长帮你长期还债。
最容易出现的错误升级路径
很多项目一开始只想做一个最小样例,于是从 simple 起步。
这没有问题。
问题出在后来已经出现下面这些信号时,仍然不升级:
- 一个文件里已经同时维护发现、诊断和渲染
- 新增字段时需要在同一个大文件里来回跳
- 你已经明确这个项目会进入正式仓库
这个阶段如果还坚持继续堆,后面每多一个需求,都在给未来加利息。
用 simple 的正确姿势
更稳的做法其实很简单:
- 把
simple当成路线验证器 - 把 sample 当成最小活体验证
- 一旦确认方向成立,就尽快升级到
standard
这样你既拿到了最快的起步速度,也没有把后续结构债务一起收进来。
一句话结论
simple 模板最适合验证生成器路线是否成立;一旦项目进入正式维护阶段,它就应该尽快把位置让给更稳定的骨架。
教程导航
继续阅读
当前文章已经挂到教程顺序中,建议按相邻章节继续。