Xamarin.Forms iOS端文本不显示问题排查求助

问题回顾 #

Android端开发的Xamarin.Forms应用运行正常，移植到iOS后出现两个核心问题：

• 所有页面布局完全错乱
• 所有文本控件（如Label）内容不显示

已完成排查：

• 新建仅含StackLayout和基础控件的测试ContentPage，问题依然存在（不受设备、模拟器、深色模式影响）
• 空白Xamarin.Forms项目在iPhone上运行正常，排除Visual Studio环境问题
• 发现给Label手动设置FontFamily=""后文本可显示，推测问题根源为字体配置异常

已尝试但无效的操作：

• 将字体文件添加到iOS项目的Resources/Fonts文件夹
• 在Info.plist中配置UIAppFonts数组
• 在跨平台项目中使用ExportFont特性注册字体

针对性解决步骤 #

1. 检查字体文件的Build Action配置 #

选中iOS项目Resources/Fonts下的字体文件，在属性面板中：

• 设置Build Action为BundleResource
• 设置Copy to Output Directory为Copy if newer

若Build Action错误，字体文件不会被打包到iOS应用中，导致系统无法识别

2. 验证Info.plist的字体配置准确性 #

打开iOS项目的Info.plist，确认UIAppFonts（即Fonts provided by application）数组中的每一项，与字体文件的**完整文件名（含后缀）**完全一致，例如：

<key>UIAppFonts</key>
<array>
    <string>Roboto-Regular.ttf</string>
    <string>Roboto-Bold.ttf</string>
</array>

注意：文件名大小写敏感，iOS系统会严格匹配

3. 修正ExportFont特性的使用 #

在跨平台项目的任意类文件（如App.xaml.cs）中，确保ExportFont的文件名与实际字体文件一致，同时指定正确的别名：

[assembly: ExportFont("Roboto-Regular.ttf", Alias = "RobotoRegular")]

在XAML中使用时，直接引用别名：

<Label Text="测试文本" FontFamily="RobotoRegular" />

若未指定别名，也可直接使用字体文件的文件名（不含后缀）作为FontFamily值

4. 排查全局样式的FontFamily覆盖 #

检查App.xaml或其他全局样式文件，是否给Label等文本控件设置了全局FontFamily属性，且该字体在iOS上未正确加载：

<Style TargetType="Label">
    <Setter Property="FontFamily" Value="不存在的字体名" />
</Style>

这种情况下，iOS无法找到指定字体，会导致文本不显示，同时控件尺寸计算错误引发布局错乱。可暂时注释该全局样式，验证是否恢复正常。

5. 验证字体是否成功加载到iOS应用 #

在iOS项目的AppDelegate.cs的FinishedLaunching方法中添加以下代码，打印所有可用字体名称，确认你的字体是否在列表中：

foreach (var family in UIFont.FamilyNames)
{
    Console.WriteLine($"字体家族：{family}");
    foreach (var font in UIFont.FontNamesForFamilyName(family))
    {
        Console.WriteLine($"  字体：{font}");
    }
}

运行应用后查看控制台输出，若找不到你的字体，说明前面的配置仍有问题。

6. 重置iOS模拟器/清理项目 #

• 清理解决方案：右键解决方案 → 清理
• 删除iOS模拟器的应用：长按模拟器中的应用图标，点击删除
• 重启模拟器和Visual Studio，重新编译运行

总结 #

iOS端文本不显示+布局错乱的核心原因，大概率是全局指定的FontFamily在iOS上未正确加载，导致系统无法渲染文本，同时控件的尺寸计算逻辑出错。按照上述步骤逐一排查配置，即可解决问题。

内容的提问来源于stack exchange，提问作者Daniel S.