装完就能用的关键三步是加包、注册服务、引入样式和脚本:先安装MudBlazor及Services包,再在Program.cs中调用AddMudServices()等方法,最后按项目类型配置CSS、JS及MudThemeProvider等全局组件。
装完就能用,关键在三步:加包、注册服务、引入样式和脚本。跳过任一环节都可能报错或 UI 不渲染。
安装 MudBlazor 包
打开项目根目录,运行命令(按你项目类型选其一):
- Blazor Server 或 Blazor WebAssembly: dotnet add package MudBlazor
- 如需服务支持(比如 Snackbar、Dialog):再加一个 dotnet add package MudBlazor.Services
- VS2022 用户也可右键项目 → “管理 NuGet 包” → 搜索 MudBlazor → 安装最新稳定版
注册服务与配置依赖
在 Program.cs(.NET 6+)中添加两行:
- builder.Services.AddMudServices();
- 若用到本地化,再加 builder.Services.AddMudBlazorTranslations();
注意:MudBlazor 不支持静态渲染(Static Rendering),确保你的组件使用的是 interactive 渲染模式(如 @rendermode InteractiveServer 或 InteractiveWebAssembly)。
注入样式、脚本与全局组件
根据项目类型操作: