Flutter项目中MaterialApp的theme配置primary颜色不生效是什么原因？

核心原因 #

1. Material 3 默认开启的适配差异 #

从Flutter 3.16版本开始，ThemeData的useMaterial3属性默认值为true。Material 3设计规范对组件默认取色规则做了大量调整：原来Material 2中很多默认使用colorScheme.primary的组件（如AppBar），Material 3下默认改用primaryContainer、surface等其他ColorScheme属性，会让你误以为primary配置没有生效。

2. ThemeData 遗留属性优先级冲突 #

如果你已经手动关闭了Material 3，还是遇到primary不生效的问题，是因为ThemeData存在primaryColor、primaryColorLight等历史遗留属性，这些属性的读取优先级高于colorScheme.primary，你只修改colorScheme不会同步更新这些遗留属性，部分旧组件读取遗留属性时就会出现配置不生效的情况。

修复方案 #

方案1：适配Material 3规范（推荐） #

推荐直接通过ColorScheme.fromSeed生成整套配色，避免单独修改单个属性出现遗漏：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(
          seedColor: Colors.blue, // 自动生成包含primary在内的全套配色
          secondary: Colors.orange,
        ),
      ),
      home: MyHomePage(),
    );
  }
}

如果需要强制指定固定的primary值，可以直接构造ColorScheme实例：

colorScheme: const ColorScheme.light(
  primary: Colors.blue,
  secondary: Colors.orange,
)

方案2：切回Material 2规范 #

如果需要沿用旧的Material 2配色逻辑，显式关闭Material 3，同时同步配置遗留的primaryColor属性：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final ThemeData theme = ThemeData(useMaterial3: false);
    return MaterialApp(
      theme: theme.copyWith(
        primaryColor: Colors.blue,
        colorScheme: theme.colorScheme.copyWith(
          primary: Colors.blue,
          secondary: Colors.orange,
        ),
      ),
      home: MyHomePage(),
    );
  }
}

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