2026-03-22
第 2 篇文件级元数据不是 JSON 的一部分,它来自 MSBuild
很多人以为命名空间、类名和可见性都应该写在 JSON 里,但第二案例里,这些单文件覆盖项更适合来自 AdditionalFiles 元数据。
这里汇总站点全部博客文章;按发布时间浏览,按系列页进入章节化阅读。
这里收录当前 Hugo 站点的全部博客文章。
建议按这两种方式使用:
当前列表按发布时间倒排;系列页内部仍按章节顺序展示。
2026-03-22
第 2 篇很多人以为命名空间、类名和可见性都应该写在 JSON 里,但第二案例里,这些单文件覆盖项更适合来自 AdditionalFiles 元数据。
2026-03-22
第 1 篇当生成器开始读取 AdditionalFiles、MSBuild 元数据和项目默认值时,它就不再只是演示案例,而是开始接近真实工程输入。
2026-03-21
第 10 篇代码渲染不只是拼一段字符串,它要负责重新打开命名空间、嵌套类型和目标类型,并保证输出代码可编译。
2026-03-21
第 12 篇主路径一旦能跑,最容易被忽略的就是可空、泛型和嵌套类型;而这些恰恰最容易让生成器在真实项目里失效。
2026-03-21
第 13 篇好的生成器不会在非法输入上默默失败,而是会明确告诉调用方为什么不能生成。
2026-03-21
第 14 篇生成器测试不能只做文本断言,更关键的是验证生成结果是否能编译、诊断是否准确、边界是否被稳稳拦住。
2026-03-21
第 15 篇排错不要一上来盯着字符串渲染,先按入口、发现、模型、诊断、输出文件这条顺序查。
2026-03-21
第 16 篇第一个生成器跑通后,真正值得继续扩的方向不是再堆一个特性,而是扩输入边界、配置边界、模板边界和交付边界。