Flutter自定义字体仅渲染两种字重，字体元数据含对应字重值

以下是几个实用的排查和解决方向：

• 核对pubspec.yaml配置细节
  确保每个字体文件的weight值与文件名、实际字重完全对应，同时检查文件路径拼写（注意大小写，Flutter在多平台对路径大小写敏感）。示例配置：

  fonts:
    - family: Museo_Slab
      fonts:
        - asset: fonts/Museo_Slab_100.otf
          weight: 100
        - asset: fonts/Museo_Slab_300.otf
          weight: 300
        - asset: fonts/Museo_Slab_500.otf
          weight: 500
        - asset: fonts/Museo_Slab_700.otf
          weight: 700
        - asset: fonts/Museo_Slab_900.otf
          weight: 900
  

• 绕过字体元数据冲突
  即使手动指定了weight，Flutter仍可能优先读取字体内部元数据的字重。可以给不同字重的字体设置独立的family名称，彻底规避冲突：

  fonts:
    - family: Museo_Slab_100
      fonts:
        - asset: fonts/Museo_Slab_100.otf
    - family: Museo_Slab_300
      fonts:
        - asset: fonts/Museo_Slab_300.otf
    - family: Museo_Slab_500
      fonts:
        - asset: fonts/Museo_Slab_500.otf
    # 依次配置700、900字重
  

  使用时直接指定对应family，无需额外设置weight：

  Text('测试文本', style: TextStyle(fontFamily: 'Museo_Slab_500'))
  

• 清理缓存并重新构建
  执行命令彻底清除旧缓存，避免残留的字体配置干扰：

  flutter clean
  flutter pub get
  flutter run
  

  iOS平台可额外删除Xcode的DerivedData，Android平台清理项目根目录的build文件夹。

• 验证字体文件实际字重
  用FontForge等工具打开字体文件，检查OS/2表中的usWeightClass值是否与预期一致。部分字体文件可能存在元数据错误，比如标注500的文件实际是300字重，导致Flutter无法区分。

• 检查Text组件的字重指定
  确保TextStyle中使用正确的FontWeight枚举值，而非直接写数字：

  TextStyle(
    fontFamily: 'Museo_Slab',
    fontWeight: FontWeight.w500, // 对应500字重，不要写成500
  )
  

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