Android Studio运行Flutter项目报错No named parameter with the name 'color'如何解决

报错原因 #

该报错是Flutter 3.10及以上版本的破坏性变更导致的，对应组件的label相关配置不再支持直接设置color命名参数，最常见的触发场景为按钮组件样式配置错误、输入框标签样式配置错误。

解决方案 #

场景1：按钮组件样式配置错误 #

错误写法示例

ElevatedButton(
  style: ButtonStyle(
    // 旧版本支持的label属性配置已被移除，直接设置color会报错
    label: TextStyle(color: Colors.white), 
  ),
  onPressed: () {},
  child: Text('测试按钮'),
)

修复写法

// 方案1：直接在Text组件内配置文本样式
ElevatedButton(
  onPressed: () {},
  child: Text('测试按钮', style: TextStyle(color: Colors.white)),
)

// 方案2：通过ButtonStyle的foregroundColor属性统一配置按钮文本颜色
ElevatedButton(
  style: ButtonStyle(
    foregroundColor: MaterialStateProperty.all(Colors.white),
  ),
  onPressed: () {},
  child: Text('测试按钮'),
)

场景2：输入框标签样式配置错误 #

错误写法示例

TextField(
  decoration: InputDecoration(
    label: Text('用户名'),
    // color不属于InputDecoration的直接参数，放在此处会报错
    color: Colors.grey, 
  ),
)

修复写法

TextField(
  decoration: InputDecoration(
    label: Text('用户名'),
    // label颜色需放在labelStyle属性下配置
    labelStyle: TextStyle(color: Colors.grey),
  ),
)

通用排查步骤 #

• 光标悬停在标红的color属性上，确认所属父组件，核对该组件的构造参数是否存在color字段
• 若刚升级了Flutter版本，可全局检索项目内所有直接为label设置color的代码，统一迁移到对应组件的style属性下配置
• 若使用了第三方UI库，可检查该库是否已适配当前使用的Flutter版本，升级到对应适配版本即可

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