Blazor WASM应用Tree Shaking与DLL修剪相关技术疑问

一、Tree Shaking的支持范围 #

• 自身应用DLL：完全支持。发布模式下，.NET SDK会自动扫描你的代码，移除所有未被实际引用的类型、方法、字段等，只保留运行必需的代码，有效缩减自身DLL体积。
• 依赖项DLL：部分支持，但存在前提限制。

二、依赖项修剪限制与SDK DLL可修剪的原因 #

依赖项无法被修剪的常见原因 #

1. 未适配修剪逻辑：多数第三方库没有针对.NET修剪做优化，比如使用了未标记依赖的反射、动态加载（如Assembly.Load），或者代码中存在模糊的引用关系，修剪工具为避免运行时错误，会保留整个DLL。
2. 代码设计缺陷：如果库中包含大量静态构造函数、全局状态，或者通过typeof获取类型信息但未直接引用成员，修剪工具会误判为需要保留的代码，无法有效修剪。
3. 默认配置保守：默认情况下，修剪工具对第三方库的策略更谨慎，若未在项目文件中显式开启对特定依赖的修剪配置，可能无法触发修剪。

SDK DLL可被修剪的原因 #

• 官方深度优化：.NET SDK自带的类库（如System.*、Microsoft.*）都经过微软专门适配，通过[RequiresUnreferencedCode]、[DynamicDependency]等属性明确代码依赖关系，修剪工具能安全识别并移除无用代码。
• 规范的代码实现：SDK DLL严格遵循.NET修剪规范，避免了模糊的反射或动态加载逻辑，确保修剪过程不会破坏运行时稳定性。

三、优化依赖项修剪的实用建议 #

• 优先选用明确支持修剪的第三方库：查看库的文档或NuGet描述，确认是否适配.NET修剪。
• 调整项目修剪配置：在.csproj中设置<TrimMode>full</TrimMode>（仅发布模式下使用），或通过<TrimmerRootAssembly>指定需要强制修剪的依赖，但务必做好测试，防止运行时异常。
• 精简依赖：只引入项目实际需要的库，尽量避免使用功能冗余的多用途大库，优先选择轻量化替代方案。

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