React Native自定义字体iOS正常，Android仅Bold生效其余失效求助

我之前也踩过Android字体适配的坑，它对字体的命名和属性匹配确实比iOS严格很多，咱们一步步来排查解决：

1. 核对Android字体文件的命名规范 #

Android系统识别字体依赖严格的文件名格式，必须让文件名明确对应字重和样式：

• 常规体（Regular）：FiraSans-Regular.ttf
• 斜体（Italic）：FiraSans-Italic.ttf
• 粗体（Bold）：FiraSans-Bold.ttf

确保文件名无空格、无特殊字符，后缀为.ttf（otf格式也兼容，但ttf适配性更好），这是Android识别字体的基础。

2. 确认正确的fontFamily名称 #

有时候字体的内部"name属性"和文件名不一致，直接使用文件名前缀作为fontFamily反而更可靠。比如直接定义：

export const Fonts = {
  regular: 'FiraSans-Regular',
  italic: 'FiraSans-Italic',
  bold: 'FiraSans-Bold'
};

注意不要加.ttf后缀，Android会自动在assets/fonts目录下查找对应文件。

3. 正确搭配fontWeight和fontStyle #

React Native在Android上，fontWeight和fontStyle会影响字体的匹配逻辑：

• 如果给常规体设置fontWeight: 'bold'，Android会自动切换到粗体字体；反过来如果给粗体设置fontWeight: 'normal'，会导致显示异常。

推荐的写法是把字体样式整合到定义中：

export const Fonts = {
  regular: { fontFamily: 'FiraSans-Regular', fontWeight: 'normal', fontStyle: 'normal' },
  italic: { fontFamily: 'FiraSans-Italic', fontWeight: 'normal', fontStyle: 'italic' },
  bold: { fontFamily: 'FiraSans-Bold', fontWeight: 'bold', fontStyle: 'normal' }
};

使用时直接展开样式：

<Text style={Fonts.italic}>这是斜体文本</Text>
<Text style={Fonts.regular}>这是常规文本</Text>

4. 清理缓存并重新编译 #

缓存经常是字体不生效的隐形原因，按以下步骤操作：

• 关闭Metro开发服务器
• 进入Android目录清理构建缓存：cd android && ./gradlew clean
• 回到项目根目录，重置Metro缓存并重启：npx react-native start --reset-cache
• 重新运行Android项目：npx react-native run-android

5. 确认字体文件的打包配置 #

检查android/app/build.gradle中是否正确配置了assets目录（react-native link一般会自动添加，但可以手动确认）：

android {
  sourceSets {
    main {
      assets.srcDirs = ['src/main/assets', 'src/main/assets/fonts']
    }
  }
}

同时确保android/app/src/main/assets/fonts目录下确实存在三个字体文件，没有遗漏或文件名错误。

如果以上方法都无效，可以尝试把文件名中的连字符去掉（比如改成FiraSansRegular.ttf），再对应修改fontFamily为FiraSansRegular，部分Android版本对特殊字符的识别存在兼容问题。

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