C# MAUI自定义字体嵌入教程
<p>在.NETMAUI中使用自定义字体需三步:一、将字体文件放入Resources/Fonts/并设BuildAction(Android/macOS/Windows为MauiFont,iOS为BundleResource);二、iOS需在Info.plist的UIAppFonts下声明字体路径;三、XAML或C#中FontFamily必须带.ttf/.otf后缀(如"MyFont.ttf")。</p>
在 .NET MAUI 中使用自定义字体需三步:一、将字体文件放入 Resources/Fonts/ 并设 Build Action(Android/macOS/Windows 为 MauiFont,iOS 为 BundleResource);二、iOS 需在 Info.plist 的 UIAppFonts 下声明字体路径;三、XAML 或 C# 中 FontFamily 必须带 .ttf/.otf 后缀(如 "MyFont.ttf")。

在 .NET MAUI 中使用自定义字体,核心是把字体文件嵌入到项目中,并在 XAML 或 C# 中正确引用。关键点有三个:字体文件添加方式、Build Action 设置、以及跨平台资源名写法(尤其注意 iOS 和 Android 的差异)。
一、添加字体文件并设置生成操作
将字体文件(如 MyFont.ttf 或 MyFont.otf)拖入 MAUI 项目的 Resources/Fonts/ 文件夹(若无则手动创建)。右键字体文件 → “属性” → 将 Build Action 设为:
- Android:`MauiFont`
- iOS:`BundleResource`(且需在
Info.plist中声明) - Windows/macOS:`MauiFont`(Windows 支持较好,macOS 需确保字体合法可分发)
⚠️ 注意:Resources/Fonts/ 是约定路径,MAUI 会自动识别该目录下的字体用于跨平台加载。
二、iOS 必须注册字体(Info.plist 配置)
iOS 不会自动加载嵌入字体,必须显式声明。打开 Platforms/iOS/Info.plist,在 内添加:
UIAppFonts Fonts/MyFont.ttf
字体文件路径要和项目中实际位置一致(区分大小写),且仅支持 .ttf / .otf 格式。
三、在 XAML 或代码中使用字体
MAUI 使用 字体文件名(不含扩展名)或 PostScript 名 引用字体。推荐优先用文件名,更稳定:
- XAML 示例:
FontFamily="MyFont.ttf"(注意带.ttf后缀) - C# 示例:
label.FontFamily = "MyFont.ttf";
✅ 正确写法(推荐):
❌ 错误写法:
(不带后缀可能在某些平台失效)
? 小技巧:如果字体显示异常,可用 FontManager.Current.GetInstalledFonts() 在运行时查看已加载的字体名(调试用)。
四、验证与常见问题
字体未生效?按顺序检查:
- 字体文件是否真在
Resources/Fonts/下,且 Build Action 正确 - iOS 是否更新了
Info.plist并重新部署(缓存可能导致旧配置残留) - FontFamily 值是否拼写准确(含后缀、大小写)
- 是否在模拟器/设备上完整重装 App(尤其 iOS 更换字体后常需彻底卸载再装)
基本上就这些。不复杂但容易忽略 Info.plist 或后缀名,踩过坑就知道关键在哪了。
Windows 10 是一款微软推出的经典操作系统,拥有硬件兼容性与多任务处理能力。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。
极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。
















