Flutter Android应用默认字体修改失败的排查方法求助

问题现象 #

• 已添加google_fonts包，在MaterialApp的theme中配置GoogleFonts.latoTextTheme，全局字体未生效；
• 单独给Text组件设置GoogleFonts.robotoMono()可以正常改变字体；
• 添加本地Noto字体到assets，在theme中配置fontFamily: 'Noto'同样无效；
• 打印DefaultTextStyle.of(context).style.fontFamily返回monospace，执行flutter clean、卸载应用后问题依旧。

问题根源 #

问题源于深色主题与浅色主题的混淆配置——如果仅在theme（浅色主题）中设置了字体，但应用实际使用的是darkTheme（深色主题），而darkTheme未同步配置字体，就会导致全局字体不生效。

解决方案 #

无论是使用Google Fonts还是本地字体，都需要确保浅色主题和深色主题的字体配置保持一致：

1. 使用Google Fonts的正确配置

MaterialApp(
  // 浅色主题配置
  theme: ThemeData(
    textTheme: GoogleFonts.latoTextTheme(ThemeData.light().textTheme),
  ),
  // 深色主题同步配置相同字体
  darkTheme: ThemeData(
    textTheme: GoogleFonts.latoTextTheme(ThemeData.dark().textTheme),
  ),
  // 指定默认主题模式，也可以让系统自动切换
  themeMode: ThemeMode.system,
  home: YourHomePage(),
);

2. 使用本地字体的正确配置

• 第一步：在pubspec.yaml中声明本地字体资源：

flutter:
  assets:
    - assets/fonts/
  fonts:
    - family: Noto
      fonts:
        - asset: assets/fonts/NotoSansSC-Regular.ttf
        - asset: assets/fonts/NotoSansSC-Bold.ttf
          weight: 700

• 第二步：同时在浅色和深色主题中配置：

MaterialApp(
  theme: ThemeData(
    fontFamily: 'Noto',
    textTheme: TextTheme(
      // 可针对不同文本样式细化配置，比如标题、正文等
      bodyLarge: TextStyle(fontFamily: 'Noto'),
      bodyMedium: TextStyle(fontFamily: 'Noto'),
    ),
  ),
  darkTheme: ThemeData(
    fontFamily: 'Noto',
    textTheme: TextTheme(
      bodyLarge: TextStyle(fontFamily: 'Noto'),
      bodyMedium: TextStyle(fontFamily: 'Noto'),
    ),
  ),
  themeMode: ThemeMode.system,
  home: YourHomePage(),
);

验证方法 #

配置完成后，建议先执行flutter clean再重新编译运行应用，打印DefaultTextStyle.of(context).style.fontFamily，应返回你配置的字体名称（如Lato或Noto）。

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