Android Jetpack Compose 如何配置自定义回退字体列表

原生Typeface.CustomFallbackBuilder并非完全无法在Jetpack Compose中使用，只是需要做简单适配，同时Compose本身已经提供了更适配声明式体系的字体回退配置能力，两种方案都可以实现「首位字体缺字时自动按顺序匹配后续字体」的效果：

• 方案1：使用Compose官方FontFamily顺序配置（推荐）
  Compose的FontFamily构造逻辑本身就支持按优先级顺序传入多个字体资源，渲染文本时会自动按传入顺序匹配：如果靠前的字体不包含待渲染的目标字符，会自动向后遍历列表，找到第一个支持该字符的字体使用，和原生字体回退逻辑完全一致。
  实现代码如下：

  // 按优先级从高到低传入字体，越靠前匹配优先级越高
  val customFallbackFontFamily = FontFamily(
      Font(R.font.your_primary_font), // 首位优先使用的主字体
      Font(R.font.first_fallback_font), // 第一顺位回退字体
      Font(R.font.second_fallback_font), // 第二顺位回退字体
      Font(FontFamily.Default) // 最后兜底用系统默认字体，避免出现缺字豆腐块
  )
  
  // 可直接配置到全局主题，也可以单独给指定Text组件设置
  MaterialTheme(
      typography = Typography(
          bodyLarge = TextStyle(fontFamily = customFallbackFontFamily),
          headlineMedium = TextStyle(fontFamily = customFallbackFontFamily)
          // 其余文本样式按需配置即可
      )
  ) {
      // 页面内容
  }
  

  如果需要适配粗体、斜体等不同字重、字形，只要给对应Font实例传入匹配的weight、style参数，Compose会自动在同字重同字形的字体列表里做回退匹配。

• 方案2：桥接原生CustomFallbackBuilder构造的Typeface
  如果已经用原生Typeface.CustomFallbackBuilder构造好了带完整回退序列的Typeface实例，不需要重复配置字体列表，可以直接通过Compose提供的Typeface桥接能力包装成Compose可识别的字体实例：

  // 按原生逻辑构造带自定义回退的Typeface
  val nativeFallbackTypeface = Typeface.CustomFallbackBuilder(
      Typeface.createFromAsset(assets, "primary_font.ttf")
  )
      .addCustomFallback(Typeface.createFromAsset(assets, "fallback_font_1.ttf"))
      .addCustomFallback(Typeface.createFromAsset(assets, "fallback_font_2.ttf"))
      .build()
  
  // 包装为Compose可用的FontFamily
  val bridgedFontFamily = FontFamily(
      Font(typeface = nativeFallbackTypeface)
  )
  

  该方案的局限性是桥接的原生Typeface无法自动适配Compose的字重、字形切换逻辑，如果有粗体、斜体的显示需求，需要分别构造对应样式的Typeface做手动映射，灵活性不如方案1。

注意：从Compose UI 1.2.0版本开始，顺序Font列表的自动回退逻辑已经稳定可用，不需要引入额外依赖，也不需要自定义文本绘制逻辑，是目前兼容性、维护成本最优的实现方式。

内容的提问来源于stack exchange，提问作者Juan P.