Blazor WebAssembly 懒加载配置教程
作者:NorthPath
时间:2025-12-29
浏览:0
BlazorWebAssembly懒加载需三步:在.csproj中声明<BlazorWebAssemblyLazyLoad>并启用<PublishTrimmed>,配置LinkerConfig.xml保留程序集,且在Program.cs注册AddLazyAssemblyLoading();三者缺一不可。
Blazor WebAssembly 懒加载需三步:在.csproj中声明
并启用 ,配置LinkerConfig.xml保留程序集,且在Program.cs注册AddLazyAssemblyLoading();三者缺一不可。

Blazor WebAssembly 支持懒加载(Lazy Loading)程序集,能显著减少首屏加载体积,提升启动速度。关键在于正确配置 LinkerConfig.xml、启用懒加载开关,并在 Program.cs 中注册按需加载的程序集。
启用懒加载开关
在项目文件(.csproj)中添加以下属性,开启 WebAssembly 懒加载支持:
—— 声明需要懒加载的程序集(可多行)YourAssembly.dll —— 推荐同时启用裁剪(与懒加载兼容)true - 确保使用 .NET 6 或更高版本(懒加载自 .NET 6 正式支持)
配置 Linker(可选但推荐)
为避免链接器误删懒加载所需的类型,需在 LinkerConfig.xml 中保留相关入口点:
- 在项目根目录创建
LinkerConfig.xml - 添加如下内容,防止懒加载程序集中的类型被裁剪:
在 Program.cs 中注册懒加载程序集
调用 WebAssemblyHostBuilder.Services.AddLazyAssemblyLoading() 启用运行时懒加载能力:
- 在
Program.cs的构建主机前添加该服务注册 - 确保所有懒加载程序集已通过
BlazorWebAssemblyLazyLoad声明,否则运行时会报错“Assembly not found” - 实际加载由
AssemblyLoadContext.Default.LoadFromStreamAsync()或组件级dynamic import触发(如路由组件或Lazy)
验证懒加载是否生效
发布后检查 wwwroot/_framework/ 目录:
- 目标程序集(如
YourAssembly.dll)应独立存在,不包含在dotnet.wasm或主程序集中 - 浏览器开发者工具的 Network 面板中,该 DLL 应在首次访问对应功能时才发起请求
- 查看控制台是否有
Loaded assembly: YourAssembly.dll日志(需启用日志级别为Debug)
基本上就这些。配置简单但细节容易出错,重点核对项目文件声明、Linker 设置和运行时注册三处是否一致。
作者最新文章
贵州省住建厅与贝壳集团签署旅居战略合作:五大维度落地方案解析
2026-09-08 18:13
上海链家安住APP:业主主动卖房功能与成交数据解析
2026-09-08 18:11
如何批量将PPT转成PDF格式?PPT转PDF工具怎么选?
2026-09-04 16:03
PDF文件怎么压缩?3个小技巧帮你减小体积
2026-09-03 18:03
小批量试产总结报告:新产品量产导入评审实战指南
2026-09-02 19:48
热门文章
更多
精品专题
更多
Mac软件
更多
WINDOWS
更多

































