Dart开发中fontFamily无法生效求助：无报错但字体无法修改

• 检查pubspec.yaml配置细节

  1. 确认层级缩进：fonts必须嵌套在flutter节点下，统一使用2个空格缩进（禁止混用Tab），示例格式：

  flutter:
    uses-material-design: true
    fonts:
      - family: CustomFont
        fonts:
          - asset: fonts/CustomFont-Regular.ttf
          - asset: fonts/CustomFont-Bold.ttf
            weight: 700
  

  2. 验证路径准确性：asset路径是相对于项目根目录的，比如字体放在assets/fonts/下，路径需写assets/fonts/xxx.ttf；注意路径大小写（Linux/macOS环境对大小写敏感）。
  3. 执行flutter pub get：修改pubspec.yaml后必须执行该命令，确保资源被正确索引。

• 代码使用逻辑检查

  1. 匹配字体族名称：Text组件的fontFamily必须和pubspec中family字段完全一致（含大小写），示例：

  Text(
    '测试文本',
    style: TextStyle(
      fontFamily: 'CustomFont', // 与pubspec的family严格匹配
      fontSize: 24,
    ),
  )
  

  2. 排查全局主题覆盖：如果在ThemeData中设置了默认fontFamily，会覆盖局部Text的字体配置，需确认主题是否影响目标组件。

• 环境与缓存问题

  1. 清理项目缓存：执行flutter clean后重新运行，避免旧资源缓存干扰。
  2. 切换测试环境：尝试在真机或不同模拟器运行，部分模拟器存在字体渲染缓存问题。
  3. 验证字体文件：将字体安装到本地系统，确认文件本身无损坏、能正常显示。

若以上步骤未解决问题，可补充以下信息：

• pubspec.yaml的完整字体配置代码
• 使用字体的Dart代码片段
• 字体文件在项目中的目录结构截图

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