Flutter开发报错：4 positional argument(s) expected, but 0 found

开发者阿泽

2026-8-28

问题根因

error: 4 positional argument(s) expected, but 0 found报错触发逻辑非常明确：你自定义的通用Navigation Bar组件构造函数声明了4个必填位置参数，但你在业务页面调用该组件时没有传入任何参数，参数数量不匹配直接触发Dart静态检查报错。
你后续添加required this.xxx后出现新报错，核心是两个问题：

你没有把组件参数放到构造函数的大括号{}包裹块中，参数依然是按位置校验的模式，加required也不会变成命名传参的格式
改完构造函数后，你没有在调用组件的位置同步传入所有标记为required的参数，或是传入的参数类型和组件声明的接收类型不匹配

修复步骤

先修改NavBar组件的构造函数定义，将所有参数调整为命名参数格式（需要强制传入的参数加required标记，非必填参数可以设置默认值或声明为可空类型），参考写法：

class NavBar extends StatelessWidget {
  final String name;
  final int currentIndex;
  final ValueChanged<int> onItemTap;
  final List<Widget> pageList;

  // 注意大括号的位置，所有参数都放在大括号内才是命名参数
  const NavBar({
    super.key,
    required this.name,
    required this.currentIndex,
    required this.onItemTap,
    required this.pageList,
  });

  @override
  Widget build(BuildContext context) {
    // 保留你原有的导航栏渲染、跳转逻辑即可
  }
}

找到所有调用NavBar组件的位置（就是你之前写NavBar()触发报错的地方），按照命名参数的格式传入所有必填参数，参考写法：

// 替换原来无参调用NavBar()的写法
NavBar(
  name: "首页",
  currentIndex: _selectedIndex,
  onItemTap: (index) {
    setState(() {
      _selectedIndex = index;
    });
  },
  pageList: _tabPages,
)

如果部分参数不需要每次调用都自定义，可以直接在构造函数里给默认值，这类参数不需要加required，调用时不传也不会报错，示例：

const NavBar({
  super.key,
  this.name = "应用", // 默认值
  this.currentIndex = 0, // 默认值
  required this.onItemTap,
  required this.pageList,
});

补充Dart构造函数参数规则：如果构造函数的参数没有被大括号包裹，默认是顺序必填的位置参数，调用时必须严格按照参数定义的顺序传值，不能缺省；只有放在大括号内的参数才是命名参数，传参时需要明确写参数名，标记required的命名参数必须传值，未标记的需要有默认值或是可空类型才能缺省。

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