MahApps/MahApps.Metro

这是什么？

核心功能

• 01通过合并资源字典原地重新设计标准 WPF 控件样式，无需替换控件。
• 02MetroWindow 提供自定义标题栏命令、发光边框和浮出面板。
• 03支持浅色与深色基础主题加强调色，可在运行时切换。
• 04可等待的对话框以覆盖层形式显示在窗口内部。
• 05通过附加属性为原生控件添加水印、清除按钮等功能。
• 06支持 .NET Framework 4.6.2 及更高版本，以及 Windows 上的 .NET 6 和 .NET 8。

适用场景

• 在不改写 XAML 的前提下，为已有的 WPF 业务应用更新界面外观。
• 使用 HamburgerMenu 和页面导航搭建侧边栏式应用框架。
• 为 WPF 主窗口添加覆盖层对话框和自定义标题栏命令。
• 让应用的浅色或深色主题跟随 Windows 系统设置。

快速上手

1. 1

   从 NuGet 页面获取 MahApps.Metro 包

2. 2

   按照文档中的快速入门指南操作

使用前须知

• !仅适用于 Windows 上的 WPF。
• !3.0 版本在 NuGet 上仍为候选发布版。
• !2.4 与 3.0 版本支持的 .NET 运行时不同,使用前请确认哪个版本适合你的项目。

标签

常见问题

MahApps.Metro 是什么？

面向 WPF 应用的 UI 工具包，为标准控件提供现代化样式，并补充窗口标题栏、主题、对话框和导航控件。 MahApps.Metro 是一个用于构建 WPF 桌面应用的 UI 工具包。它通过合并资源字典为 Button、TextBox、DataGrid、TreeView 等标准控件重新套用样式，现有 XAML 无需改写，也不必替换为新的控件类型。

MahApps.Metro 可以免费使用吗？用的什么许可证？

MahApps.Metro 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

MahApps.Metro 还在维护吗？

活跃维护中。MahApps.Metro 最近一次提交是在 2026年10月21日。

MahApps.Metro 适合用来做什么？

在不改写 XAML 的前提下，为已有的 WPF 业务应用更新界面外观。 使用 HamburgerMenu 和页面导航搭建侧边栏式应用框架。 为 WPF 主窗口添加覆盖层对话框和自定义标题栏命令。 让应用的浅色或深色主题跟随 Windows 系统设置。

MahApps.Metro 怎么安装和运行？

从 NuGet 页面获取 MahApps.Metro 包 按照文档中的快速入门指南操作

在哪里获取 MahApps.Metro？

源代码和安装说明在 GitHub 上：https://github.com/MahApps/MahApps.Metro