如何在DocFX中为C#分部类生成独立文档？

问题场景 #

我把OrderProcessor分部类拆在了两个文件里：

• Payment.cs包含支付相关方法：ProcessPayment、ApplyDiscounts等
• Shipping.cs包含物流相关方法：PrepareShipment、GenerateTrackingNumber等

DocFX默认会把所有分部类合并成单个OrderProcessor文档条目，但我需要每个文件对应独立的文档章节，单独展示各自的方法。目前的临时方案是先修改类名生成文档，再改回源码，流程繁琐，想找更优解。

DocFX原生支持现状 #

DocFX目前没有原生支持为分部类的不同源文件生成独立文档章节，它会遵循CLR的类型模型，将所有分部类的成员合并到同一个类型的文档中，这是默认且唯一的原生行为。

无需修改源码的优化方案 #

1. 手动拆分+DocFX关联 #

不用改源码，通过自定义文档结构实现拆分：

• 先正常生成合并后的OrderProcessor主文档
• 新建两个独立的Markdown文件（比如PaymentMethods.md和ShippingMethods.md），分别整理对应文件里的方法说明
• 在主文档中添加跳转链接，指向这两个拆分章节；或者用DocFX的xref语法，将不同文件的方法关联到各自的独立页面

这种方式无需改动代码，但需要手动维护拆分后的文档内容，适合方法变动不频繁的场景。

2. 自定义DocFX插件 #

如果需要自动化拆分，可以开发自定义插件：

• 借助Roslyn语法树解析代码，识别每个方法所属的源文件
• 在文档生成阶段，将同一类型下的方法按源文件分组，生成独立的章节或页面
• 插件需要实现DocFX的扩展点（比如IMarkdownEngine），处理类型文档的拆分逻辑

替代工具推荐 #

如果DocFX无法满足需求，可以试试这些工具：

• Sandcastle Help File Builder：支持按源文件组织文档结构，能识别分部类的不同文件，可配置将每个文件的成员单独生成章节
• Docu：轻量级文档生成工具，允许通过自定义模板和配置，按源文件拆分分部类的文档展示
• Wyam：基于.NET的静态站点生成器，结合Roslyn解析代码，可完全自定义文档结构，轻松实现按文件拆分分部类文档

推动DocFX功能支持 #

如果想让DocFX原生支持该功能，可以在其仓库提交Issue，建议包含：

• 明确的需求场景（按源文件拆分分部类文档）
• 示例代码和预期的文档输出结构
• 现有临时方案的痛点说明

内容的提问来源于stack exchange，提问作者Status Unknow