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
相关产品推荐
相关产品推荐

