You need to enable JavaScript to run this app. Expo+React Native TypeScript自定义Inter Display字体权重加载异常
优惠活动
大模型
产品
解决方案
定价
更多

Expo+React Native TypeScript自定义Inter Display字体权重加载异常

排查与解决方案

1. 校验字体注册逻辑

当前你在Font.loadAsync中将4个字体文件分别注册为4个完全独立的字体族,而非同一字体族下的字重映射,这是触发回退的最常见原因:

  • 该注册模式下,使用semi-bold、bold字重时,必须直接指定完整的已注册字体族名称,例如写fontFamily: 'inter-display-semibold'
  • 若使用fontFamily: 'inter-display'搭配fontWeight: '600',系统会找不到名为inter-display的字体族,直接回退到系统默认字体,且不会抛出加载类报错

如果需要通过fontWeight属性直接匹配对应字重,需将同一字体族的所有字重通过数组形式绑定到同一个注册key下,示例写法:

await Font.loadAsync({
  'inter-display': [
    require('../assets/fonts/InterDisplay-Regular.ttf'),
    require('../assets/fonts/InterDisplay-Medium.ttf'),
    require('../assets/fonts/InterDisplay-SemiBold.ttf'),
    require('../assets/fonts/InterDisplay-Bold.ttf'),
  ]
});

配置完成后,即可通过fontFamily: 'inter-display'搭配fontWeight: 'normal' / '500' / '600' / '700'的方式直接调用对应字重。

2. 验证独立字重的加载有效性

先排除字体文件本身异常的可能,在页面中添加测试组件,直接调用已注册的独立字体族:

<Text style={{ fontFamily: 'inter-display-bold' }}>测试粗体显示</Text>
<Text style={{ fontFamily: 'inter-display-semibold' }}>测试半粗体显示</Text>
  • 若测试文本无法显示对应字重:检查注册的key名与调用名是否完全一致(注意大小写、连字符拼写,例如是否将inter-display-semibold误写为inter-display-semi-bold),同时验证对应ttf文件是否损坏、是否被正确打包进应用
  • 若测试文本可正常显示:说明字体加载流程无异常,问题出在UI Kitten的配置环节

3. 修正UI Kitten配置

当前你提供的mapping.json配置存在两处明显问题:

  • 仅覆盖了text-heading-1、text-paragraph-1两个文本层级的字体族,其余所有UI Kitten内置组件(按钮、其他层级标题、标签、输入框等)仍使用默认系统字体配置
  • 严格模式下若未配置多字重映射的字体族,残留默认的fontWeight字段会触发Android端字体匹配失败,直接回退

修正参考:

{
  "strict": {
    // 若使用数组多字重注册方式,此处直接写基础字体族名inter-display即可
    "text-font-family": "inter-display",
    "text-heading-1-font-size": 32,
    "text-heading-1-font-weight": "500",
    "text-heading-2-font-weight": "600",
    "text-paragraph-1-font-size": 16,
    "text-paragraph-1-font-weight": "400"
  }
}

注意:如果保留独立字体族的注册方式(即4个分开的注册key),需要为每个使用非regular字重的文本层级单独指定对应的fontFamily值,同时移除对应fontWeight字段,否则会触发匹配失败。

4. Android端特殊场景处理

若上述配置完成后仍在Android端出现回退,需注意:

  • 部分定制Android系统会屏蔽非系统字体的字重匹配,这种场景下必须完全移除fontWeight配置,直接指定对应字重的独立字体族名称才能生效
  • 不要在同一个组件样式中同时写fontFamily和fontWeight两个属性,除非已经按照数组方式完成了同字体族的多字重绑定

内容的提问来源于stack exchange,提问作者Cristian Flórez

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 03:06:06