Flutter 位置参数需置于命名参数前 报错排查

• 核心触发点是LoginScreen页面中调用AuthButton时括号书写错误：AuthButton构造函数传参结束后多写了一个冗余的右括号)，导致Dart语法解析器误将后续代码识别为错位的位置参数，直接抛出「位置参数必须放在命名参数之前」的语法报错。错误代码片段如下：

// 错误写法：传参结束后多了一个)，提前闭合了AuthButton构造函数
AuthButton(
  text: 'Request OTP', listener: () {Navigator.of(context).pushNamed('/otp');}),
),

• 除此之外AuthButton组件内部还有两处隐性语法/规范问题：
  • onPressed回调中调用listener()后错误使用逗号结尾，Dart中函数体内语句必须以分号结尾，会触发额外语法报错
  • listener参数定义为宽泛的Function类型，没有约束回调签名，后续开发容易出现传参类型错误
  • 原组件未给MaterialButton设置背景色，按钮默认透明，白色文字会和白色页面背景融合导致按钮不可见

• 第一步：修正LoginScreen中AuthButton的调用代码，删除冗余括号，调整后代码如下：

AuthButton(
  text: 'Request OTP',
  listener: () {
    Navigator.of(context).pushNamed('/otp');
  },
),

• 第二步：优化AuthButton组件的代码：
  1. 将listener的类型从宽泛的Function改为Flutter内置的VoidCallback（即无参数无返回值的回调类型，和onPressed的签名完全匹配）
  2. 修正onPressed中的语法错误，因为回调签名完全匹配，可以直接将listener传给onPressed简化代码
  3. 补充按钮背景色属性，保证按钮正常显示
     修正后的完整AuthButton代码如下：

class AuthButton extends StatelessWidget {
  final String text;
  final VoidCallback listener;

  const AuthButton({Key? key, required this.text, required this.listener})
      : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Container(
      padding: const EdgeInsets.only(left: 20, right: 20),
      child: MaterialButton(
        onPressed: listener,
        color: const Color(0xFF7A5AF8), // 可根据项目主题替换为实际需要的按钮主色
        shape: RoundedRectangleBorder(
          borderRadius: BorderRadius.circular(10),
        ),
        padding: const EdgeInsets.symmetric(vertical: 20, horizontal: 30),
        minWidth: double.infinity,
        child: Text(
          text,
          style: const TextStyle(
            color: Colors.white,
          ),
        ),
      ),
    );
  }
}

内容的提问来源于stack exchange，提问作者I. Antonov