用途:为 Flutter 应用提供 Material 3 主题最佳实践,把 ThemeData 作为颜色、字体、组件样式和间距的唯一来源,避免在组件内联硬编码。
主要能力与规范:颜色统一通过 Theme.of(context).colorScheme 引用,禁止使用 Colors.blue 等硬编码;字体通过 Theme.of(context).textTheme 获取,build 内不出现 fontSize、fontWeight;使用 ColorScheme 结构化颜色系统;组件主题集中定义在 ThemeData 中(如 FilledButtonThemeData、InputDecorationTheme),而非逐组件设置;用基准单位定义间距体系,避免任意像素值;从一开始支持浅色与暗色主题,通过 theme 与 darkTheme 传入 MaterialApp,组件内不做亮度分支;优先使用 EdgeInsets.only 与 EdgeInsets.symmetric,不用 EdgeInsets.fromLTRB。
用法要点:定义 AppColors 集中颜色常量,配置 ColorScheme(浅色与暗色各一份);定义 AppTextStyle 并集成进 textTheme;定义 AppSpacing 基于基准单位(如 16)的命名常量;在 AppTheme 中组装 ColorScheme、TextTheme 与组件主题;将 AppTheme.light 与 AppTheme.dark 传给 MaterialApp。替换硬编码 TextStyle 时,按大小与字重映射到已有 AppTextStyle 槽位,仅用 copyWith 改颜色。消除重复组件样式时移入对应组件主题并删除各调用点,不要用包装组件或共享常量替代。
适用场景:Flutter 项目主题搭建、重构与代码审查。
限制:资料未提供具体安装命令、依赖版本、收费或价格信息;示例中省略号部分需参考随附 references 文件补全。