Flutter升级SDK后无法使用primary和onPrimary参数求助

问题原因 #

升级Flutter SDK后，官方默认启用了Material3设计规范，ElevatedButton.styleFrom中的primary和onPrimary参数已被废弃，替换为backgroundColor和foregroundColor，因此IDE会提示参数未定义。

方案1：强制关闭Material3（继续使用原参数） #

在MaterialApp中添加useMaterial3: false，切换回Material2的样式系统，即可正常使用primary和onPrimary：

import 'package:flutter/material.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      useMaterial3: false, // 关闭Material3
      home: Scaffold(
        appBar: AppBar(
          title: Text('Button'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              print('Button Pressed');
            },
            child: Text('Mon bouton'),
            style: ElevatedButton.styleFrom(
              primary: Colors.blue,
              onPrimary: Colors.white,
            ),
          ),
        ),
      ),
    );
  }
}

方案2：扩展方法兼容Material3（不关闭Material3） #

如果想保留Material3特性，同时兼容旧参数，可以给ElevatedButton写一个扩展方法，将primary和onPrimary映射到新参数：

import 'package:flutter/material.dart';

extension ElevatedButtonStyleCompat on ElevatedButton {
  static ButtonStyle styleFrom({
    Color? primary,
    Color? onPrimary,
    double? elevation,
    // 可按需添加其他兼容参数
  }) {
    return ElevatedButton.styleFrom(
      backgroundColor: primary,
      foregroundColor: onPrimary,
      elevation: elevation,
    );
  }
}

// 使用示例
void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Button')),
        body: Center(
          child: ElevatedButton(
            onPressed: () => print('Button Pressed'),
            child: Text('Mon bouton'),
            style: ElevatedButtonStyleCompat.styleFrom(
              primary: Colors.blue,
              onPrimary: Colors.white,
            ),
          ),
        ),
      ),
    );
  }
}

关于重装旧版本无效的说明 #

如果重装旧SDK后仍报错，大概率是以下原因：

• IDE未切换到指定的旧版本SDK，可在VSCode左下角的Flutter版本选择器中切换
• 新项目默认启用Material3，即使旧SDK也可能因配置触发该提示
• 检查pubspec.yaml中是否指定了高版本Flutter依赖范围，导致自动拉取新版本

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