Flutter中已弃用的backgroundColor替代方案及colorScheme报错解决

你遇到的「undefined name 'colorScheme'」错误，是因为不能直接在ThemeData.copyWith()里直接引用colorScheme变量。正确的做法是通过修改colorScheme参数来设置背景色，具体方案如下：

正确代码示例 #

方式一：链式调用写法 #

Widget build(BuildContext context) {
  return MaterialApp(
    debugShowCheckedModeBanner: false,
    title: 'My app',
    theme: ThemeData.dark().copyWith(
      // 基于原有深色主题的colorScheme，替换background值
      colorScheme: ThemeData.dark().colorScheme.copyWith(
        background: backgroundColor,
      ),
    ),
    home: const Text("My UI page"),
  );
}

方式二：先存主题实例（更易读） #

Widget build(BuildContext context) {
  // 先获取默认深色主题实例
  final defaultDarkTheme = ThemeData.dark();
  
  return MaterialApp(
    debugShowCheckedModeBanner: false,
    title: 'My app',
    theme: defaultDarkTheme.copyWith(
      colorScheme: defaultDarkTheme.colorScheme.copyWith(
        background: backgroundColor,
      ),
    ),
    home: const Text("My UI page"),
  );
}

原理说明 #

Flutter 废弃backgroundColor后，统一通过ColorScheme管理主题颜色体系。要修改背景色，需要：

1. 拿到原有主题的colorScheme对象
2. 调用colorScheme.copyWith()修改background属性
3. 将新的colorScheme传入ThemeData.copyWith()的colorScheme参数中

这样就能正确替换原有的backgroundColor设置，同时符合Flutter最新的主题规范。

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