Flutter自定义ThemeData在Release模式下失效求助

问题场景 #

Flutter 3.19.6项目中，app_theme.dart定义的浅色主题在Debug模式下完全正常，但构建Release版本后，自定义的颜色、样式均未正确应用。项目已在MaterialApp中配置themeMode: ThemeMode.system和theme: lightTheme，且在Flutter 3.19.0版本前功能正常。

排查与解决方案 #

1. 修复ThemeData定义中的语法错误 #

检查提供的主题代码，textTheme块存在未闭合的语法问题：textTheme: TextTheme(内部的titleMedium配置后未添加闭合括号与逗号，直接衔接inputDecorationTheme。Debug模式可能因Dart的语法容错机制暂时运行，但Release编译时会导致主题构造异常，需修正：

final ThemeData lightTheme = ThemeData(
  useMaterial3: true,
  fontFamily: "Inter",
  brightness: Brightness.light,
  colorScheme: ColorScheme.light(
    background: AppColor.backgroundLight,
    onBackground: AppColor.black,
    primary: AppColor.primary,
    surface: AppColor.greyLight,
    inverseSurface: Colors.grey.shade400,
    inversePrimary: AppColor.black,
  ),
  textTheme: TextTheme(
    titleLarge: const TextStyle().copyWith(
      fontSize: 24.sp,
      fontWeight: FontWeight.w600,
      color: AppColor.black,
    ),
    titleMedium: const TextStyle().copyWith(
      fontSize: 22.sp,
      fontWeight: FontWeight.w600,
      color: AppColor.black,
    ),
  ), // 补全textTheme的闭合括号
  inputDecorationTheme: InputDecorationTheme(
    // 原有输入框样式配置
  ),
  textButtonTheme: TextButtonThemeData(
    // 原有文本按钮样式配置
  ),
);

2. 防止主题变量被Dart树摇优化移除 #

Release模式下Dart会执行树摇优化，若lightTheme未被编译器识别为核心依赖，可能被误删。添加@pragma('vm:entry-point')注释标记该变量，告知编译器保留：

@pragma('vm:entry-point')
final ThemeData lightTheme = ThemeData(...);

3. 验证自定义字体的Release打包配置 #

确保pubspec.yaml中正确配置Inter字体，且Release打包时包含字体资源：

flutter:
  fonts:
    - family: Inter
      fonts:
        - asset: assets/fonts/Inter-Regular.ttf
        - asset: assets/fonts/Inter-SemiBold.ttf
          weight: 600
  assets:
    - assets/fonts/

执行flutter clean && flutter pub get后重新打包Release版本。

4. 检查屏幕扩展方法的初始化 #

项目中使用的sp、h、w、r等尺寸扩展（通常来自flutter_screenutil）需在main()中提前初始化，确保Release模式下尺寸计算正常：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ScreenUtil.ensureScreenSize();
  ScreenUtil.init(
    BoxConstraints(maxWidth: 430, maxHeight: 932),
    designSize: const Size(375, 812),
    minTextAdapt: true,
  );
  runApp(MyApp());
}

5. 替换ColorScheme构造方式适配Material 3 #

尝试使用ColorScheme.fromSeed替代ColorScheme.light，提升Material 3在Release模式下的兼容性：

colorScheme: ColorScheme.fromSeed(
  seedColor: AppColor.primary,
  brightness: Brightness.light,
  background: AppColor.backgroundLight,
  onBackground: AppColor.black,
  surface: AppColor.greyLight,
  inverseSurface: Colors.grey.shade400,
  inversePrimary: AppColor.black,
),

6. 补充darkTheme配置 #

即使仅使用浅色主题，为MaterialApp补充darkTheme配置可避免系统主题切换时的异常：

MaterialApp(
  themeMode: ThemeMode.system,
  theme: lightTheme,
  darkTheme: ThemeData.dark(), // 或自定义暗色主题
  home: const HomePage(),
);

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