Flutter自定义fontFamily不生效问题求助

Hey there! Let's work through fixing that IndieFlower font not showing up in your Flutter app—this is a super common issue when adding custom fonts, so I’ll walk you through the key checks and fixes step by step.

1. 先确认pubspec.yaml的配置是否准确 #

YAML文件对缩进和拼写格外敏感，这往往是问题的根源。你的配置应该严格按照下面的格式来：

flutter:
  uses-material-design: true
  # 注意：fonts节点必须和uses-material-design同级，缩进为2个空格
  fonts:
    - family: IndieFlower  # 这个名称要和代码里的fontFamily完全匹配
      fonts:
        - asset: fonts/IndieFlower-Regular.ttf  # 路径要和实际文件位置一致

要重点检查：

• 所有缩进都是2个空格，绝对不能用Tab键
• family的拼写（包括大小写）要和你代码里fontFamily: 'IndieFlower'完全一致
• asset路径要准确：确认字体文件确实在项目根目录的fonts文件夹下，文件名没有拼写错误（比如有没有把IndieFlower写成Indieflower，iOS系统对文件名大小写是敏感的）

2. 执行正确的依赖刷新操作 #

修改pubspec.yaml后，别直接热重载！请按顺序做：

1. 在项目根目录运行命令：flutter pub get
2. 完全重启你的Flutter应用（不是热重载/热重启），因为热重载有时候不会加载新的字体资源

3. 简化测试代码排除干扰 #

有时候其他样式或者组件可能影响字体显示，你可以先写一个极简的测试组件来验证：

Center(
  child: Text(
    "Hello IndieFlower!",
    style: TextStyle(
      color: Colors.black87,
      fontSize: 25.0,
      fontFamily: 'IndieFlower', // 确保和pubspec里的family名称完全一致
    ),
  ),
)

4. 额外的排查小技巧 #

如果上面的步骤都试过还是不行：

• 运行flutter clean清理项目缓存，然后重新构建应用（尤其是iOS端，缓存问题很常见）
• 打开fonts文件夹确认字体文件确实存在，而且没有被误放在其他子目录里
• 检查字体文件本身是否损坏：可以在本地系统打开这个.ttf文件，确认它能正常显示

Try these steps one by one, and I’m pretty sure your IndieFlower font will start working as expected. Tiny details like indentation or spelling are almost always the culprit here!

内容的提问来源于stack exchange，提问作者chk.buddi