2026-03-22
第 7 篇分层配置不该等到第二个仓库才设计
模板第一次落地时如果不先想清楚默认值、仓库级覆盖和文件级覆盖的边界，第二次接入时通常就会开始出现配置债。
标签
MSBuild
这里汇总所有属于当前标签的博客文章。
2026-03-22
第 7 篇目录约定不是装饰，它直接改变输出命名空间身份
当目录约定进入第二案例后，目录层级不再只是文件组织方式，而会正式进入生成器的命名空间决议。
2026-03-22
第 3 篇全局默认值一旦进入生成器，契约边界就变了
项目级默认命名空间、类名和可见性不是便利配置而已，它们会直接改变生成器的输出契约和回退路径。
2026-03-22
第 2 篇文件级元数据不是 JSON 的一部分，它来自 MSBuild
很多人以为命名空间、类名和可见性都应该写在 JSON 里，但第二案例里，这些单文件覆盖项更适合来自 AdditionalFiles 元数据。