ReportGenerator项目中.netconfig文件assemblyfilters参数解析问题分析

问题背景

在ReportGenerator工具的配置文件中，用户发现使用.netconfig格式配置assemblyfilters参数时，当尝试通过分号分隔多个过滤规则时，只有第一条规则生效。经过项目维护者的深入调查，发现这是由于.netconfig文件格式本身的特性导致的。

技术细节

在ReportGenerator工具中，assemblyfilters参数用于指定需要排除的程序集过滤规则。用户最初尝试使用分号分隔多个规则：

[ReportGenerator]
assemblyfilters = -*Test*;-NServiceBus*

然而实际运行时发现只有-*Test*规则生效，-NServiceBus*规则被忽略。经过分析，这是因为.netconfig文件格式将分号视为注释开始符号，导致分号后的内容被当作注释处理。

解决方案

项目维护者提供了两种解决方案：

1. 使用逗号替代分号：在最新发布的5.4.0版本中，ReportGenerator已修改解析逻辑，现在可以使用逗号作为分隔符：

   [ReportGenerator]
   assemblyfilters = -*Test*,-NServiceBus*
   

2. 使用多个独立参数：另一种方式是使用多个assemblyfilter参数分别指定规则：

   [ReportGenerator]
   assemblyfilter = -*Test*
   assemblyfilter = -*NServiceBus*
   

最佳实践建议

1. 对于新项目，建议直接升级到5.4.0或更高版本，使用逗号分隔的语法
2. 如果因某些原因无法升级，可以采用多个独立参数的方式
3. 在编写.netconfig文件时，注意避免使用分号，除非确实需要添加注释
4. 对于复杂的过滤规则，建议拆分为多个独立参数，提高可读性

版本兼容性说明

此问题在ReportGenerator 5.4.0版本中得到修复。使用旧版本的用户需要注意分号带来的注释问题，或者考虑升级到最新版本以获得更好的使用体验。