装完就能用的关键三步是加包、注册服务、引入样式和脚本:先安装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)。
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
注入样式、脚本与全局组件
根据项目类型操作:
-
Blazor WebAssembly:在 wwwroot/index.html 的
<head>中加字体和 CSS:
<link href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap" rel="stylesheet" />
<link href="_content/MudBlazor/MudBlazor.min.css" rel="stylesheet" />
在<body>底部加 JS:
<script src="_content/MudBlazor/MudBlazor.min.js"></script> -
Blazor Server:在 Pages/_Layout.cshtml 的
<head>中加同上 CSS 和字体;删掉或注释掉默认的site.css引用,避免样式冲突 - 在 App.razor 最外层组件内加入两个必备提供者:
<MudThemeProvider />
<MudSnackbarProvider />
<MudDialogProvider />
<MudTooltipProvider />
写第一个 Mud 组件试试
比如在 Index.razor 里放个按钮和弹窗提示:
- <MudButton OnClick="ShowSnackbar">点我</MudButton>
- 在 @code 块中加方法:
private void ShowSnackbar() => Snackbar.Add("Hello from MudBlazor!", Severity.Success); - 别忘了在 @code 上方注入服务:
@inject ISnackbar Snackbar
运行后点击按钮,右下角应出现绿色提示 —— 成功了。
基本上就这些。不复杂但容易忽略细节,比如漏掉 MudThemeProvider 会导致主题色失效,漏掉 JS 文件图标会显示为方块。

















