用途:为 .NET 库作者提供二进制与源代码兼容性规则,判断 API 变更对已编译程序集和消费者源码的影响,并映射到 SemVer 版本号。基线为 .NET 8.0+,规则适用于各 .NET 版本,示例面向现代 SDK 风格项目。
主要能力:区分二进制兼容(安全变更如新增公共类型、新增重载、加可选参数、放宽访问修饰符、接口默认实现;破坏性变更如删除类型或方法、改返回类型或参数类型、改字段类型、重排结构体字段、加抽象成员、密封类、改命名空间)与源代码兼容(重载解析歧义、扩展方法冲突、可选参数默认值变化、参数改名、类与结构体互换等)。介绍类型转发器:在原程序集用 [assembly: TypeForwardedTo(typeof(...))] 转发,目标程序集可用 [TypeForwardedFrom] 记录来源,对序列化兼容尤为重要。给出 SemVer 影响映射表与 [Obsolete] 弃用生命周期(警告→error: true→主版本移除)。
使用方式:在 .csproj 中启用 <EnablePackageValidation>true</EnablePackageValidation> 并设置 <PackageValidationBaselineVersion>,构建时报告 CP0002、CP0006 等破坏性变更;用 dotnet pack /p:GenerateCompatibilitySuppressionFile=true 生成 CompatibilitySuppressions.xml,并通过 <ApiCompatSuppressionFile> 项指定抑制文件。
适用场景:库重构拆分或合并程序集、跨主版本移除 API、多目标框架增删、发布前兼容性校验。
限制:不覆盖 HTTP API 版本控制、NuGet 元数据与签名发布、多 TFM 打包机制、PublicApiAnalyzers 与 Roslyn 分析器配置,这些由其他技能处理。资料未提供具体价格、平台或效果信息。