.NET 7程序集剪裁移除构造函数的解决方法及库作者建议

一、解决当前项目的剪裁问题 #

• 确认<IsTrimmable>的作用范围：这个属性默认只对当前项目生效，如果是在你的库项目里设置，但使用者的应用项目开启了剪裁，库的设置可能被覆盖。要确保使用者的应用项目中也针对你的库设置<IsTrimmable>false</IsTrimmable>，或者在库的项目文件中同时设置<IsTrimmable>false</IsTrimmable>和<Trimmable>false</Trimmable>（部分场景下需要后者）。
• 用剪裁注解保留构造函数：给通过反射访问的类型或解析类型的代码添加[DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicConstructors)]特性，明确告诉剪裁工具这些构造函数不能被移除。比如：

  [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicConstructors)]
  public Type ResolveViewType()
  {
      return typeof(MainView);
  }
  

  也可以直接给视图/窗口类本身标记这个特性，确保无参构造函数被保留。
• 使用剪裁配置文件：创建trim.xml文件，指定需要保留的类型和构造函数，将文件设置为项目的EmbeddedResource。示例内容：

  <linker>
    <assembly fullname="HanumanInstitute.Converter432hz">
      <type fullname="HanumanInstitute.Converter432hz.Views.MainView">
        <method name=".ctor" />
      </type>
    </assembly>
  </linker>
  

• 排查分层剪裁影响：如果启用了分层剪裁，可能导致部分设置不生效，可以临时在项目文件中添加<TieredCompilation>false</TieredCompilation>排查，但优先用注解方式解决，不要长期关闭分层剪裁。

二、给库使用者的最佳实践建议 #

• 添加专门的剪裁兼容文档：在库的README或文档站点里新增一节，详细说明启用剪裁时的配置步骤，包括需要添加的特性、项目配置项等。
• 封装剪裁友好的注册API：避免使用者直接依赖反射，提供强类型的视图注册方法，在方法上添加[DynamicallyAccessedMembers]特性自动处理保留逻辑。比如：

  [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicConstructors)]
  public void RegisterView<TView>() where TView : Window
  {
      // 内部注册逻辑
  }
  

• 提供预定义的剪裁规则文件：在库中附带MvvmDialogs.trim.xml，使用者可以直接将其加入自己的项目，作为剪裁规则的参考。
• 明确提示库的剪裁属性设置：告诉使用者在应用项目的PackageReference中针对你的库设置<IsTrimmable>false</IsTrimmable>，示例：

  <PackageReference Include="MvvmDialogs" Version="x.x.x">
    <IsTrimmable>false</IsTrimmable>
  </PackageReference>
  

• 引导使用依赖注入创建视图：推荐使用者通过DI容器注册视图，库内部通过DI解析实例而非直接反射。DI容器通常会自动处理剪裁时的构造函数保留问题，也更贴合现代.NET应用架构。

内容的提问来源于stack exchange，提问作者Etienne Charland