Windows C# MAUI如何使用单文件多字重的Noto Sans字体？

问题背景 #

使用单文件包含100-800多字重的Noto Sans字体，Windows字体管理器中显示为Noto Sans Light、Noto Sans SemiBold等独立名称，但MAUI的Label控件无法直接指定对应字重，且不想采用单字重多文件的注册方式（磁盘占用过高）。

可行解决方案 #

以下是在Windows平台MAUI中成功使用这类多字重单文件字体的步骤：

1. 配置项目字体文件 #

• 将多字重的Noto Sans字体文件（如.ttc格式）复制到项目的Resources/Fonts目录下
• 在文件属性中，设置生成操作为MauiFont，并将复制到输出目录设为如果较新则复制

2. 注册字体族 #

在MauiProgram.cs中注册字体时，只需指定统一的字体族名，无需单独注册每个字重：

builder.ConfigureFonts(fonts =>
{
    // 第二个参数是自定义的字体族名称，需与字体内部的正式族名匹配
    fonts.AddFont("NotoSansCJKsc.ttc", "NotoSansCJK");
});

提示：可通过Windows字体属性窗口查看字体的正式族名，确保注册时的名称一致。

3. 在Label中指定字重 #

通过FontFamily指定注册的字体族名，再用FontWeight属性直接设置对应字重值：

XAML示例

<StackLayout>
    <Label Text="轻量字重测试" FontFamily="NotoSansCJK" FontWeight="Light" />
    <Label Text="常规字重测试" FontFamily="NotoSansCJK" FontWeight="Regular" />
    <Label Text="半粗体字重测试" FontFamily="NotoSansCJK" FontWeight="SemiBold" />
    <Label Text="粗体字重测试" FontFamily="NotoSansCJK" FontWeight="Bold" />
</StackLayout>

代码后台示例

var lightLabel = new Label
{
    Text = "轻量字重测试",
    FontFamily = "NotoSansCJK",
    FontWeight = FontWeight.Light
};

关键注意事项 #

• MAUI在Windows平台的FontWeight映射遵循标准CSS字重数值：100(Thin)、300(Light)、400(Regular)、600(SemiBold)、700(Bold)、800(ExtraBold)，需确保字体文件支持对应数值的字重
• 不要直接使用Windows字体管理器中显示的Noto Sans Light这类带字重的名称作为FontFamily，必须使用统一的字体族名
• 若出现字重不生效的情况，可通过Windows的「字符映射表」工具确认字体的可用字重和族名是否正确

内容的提问来源于stack exchange，提问作者ss1969