用途:帮助 .NET 8+ 应用和类库实现裁剪安全(trim-safe)开发,减少发布体积并避免运行时因裁剪导致的缺失成员问题。
主要能力:
- MSBuild 属性区分应用与类库:应用用 PublishTrimmed、EnableTrimAnalyzer;类库用 IsTrimmable、IsAotCompatible,类库不设 PublishTrimmed。
- 裁剪注解:RequiresUnreferencedCode、DynamicallyAccessedMembers、DynamicDependency、UnconditionalSuppressMessage。
- ILLink 描述符 XML 保留类型/方法/程序集,通过 TrimmerRootDescriptor 注册;整程序集可用 TrimmerRootAssembly。
- TrimmerSingleWarn=false 输出逐条警告,便于定位问题。
- IL2xxx/IL3xxx 警告参考与修复,如 IL2026、IL2057、IL2060、IL2070、IL3050 等。
- 裁剪后测试与 CI 门禁:发布裁剪二进制并跑冒烟/集成测试,用 /warnaserror 拦截警告。
- 类库作者指南:设置 IsTrimmable,注解反射 API,提供裁剪安全替代 API。
使用方式:在 .csproj 中配置属性;用 dotnet publish -c Release -r linux-x64 /p:PublishTrimmed=true 发布;调试时加 /p:TrimmerSingleWarn=false;CI 中 dotnet build /p:EnableTrimAnalyzer=true /p:TrimmerSingleWarn=false /warnaserror:IL2026,IL2057,IL2060,IL2067,IL2070,IL3050。
适用场景:需要发布裁剪版 .NET 应用、编写裁剪安全类库、修复裁剪警告、建立裁剪 CI 门禁的团队。
限制:不覆盖 Native AOT 发布管线、AOT 设计模式、WASM AOT、MAUI AOT、源生成器编写、序列化深度、容器部署与性能模式,这些由其他技能处理。不要用 RD.xml(现代 .NET 会静默忽略),不要滥用 UnconditionalSuppressMessage,不要给不使用反射的方法加 RequiresUnreferencedCode。