Flutter报错未定义title命名参数(undefined_named_parameter)如何解决

错误根因 #

你遇到的编译错误是Flutter版本迭代导致的API变更：

• Flutter 3.0及以上正式版本中，BottomNavigationBarItem 组件已经彻底移除了旧版本的title命名参数，该参数在Flutter 2.x阶段被标记为废弃，不再支持传入Widget类型的自定义标题。

修复步骤 #

• 移除所有BottomNavigationBarItem下的title:参数配置
• 原title中传入的文字内容，改用label参数接收，注意label只接受字符串类型，不需要手动包裹Text组件
• 原title中配置的文字样式、间距等属性，统一挪到父组件BottomNavigationBar的全局样式属性中配置，不需要单独给每个导航项加Padding

修复代码示例 #

错误写法（当前触发报错的代码） #

BottomNavigationBarItem(
  // 原有icon配置保留
  title: Padding(
    padding: const EdgeInsets.all(8.0),
    child: Text(
      AppLocalizations.of(context).main_screen_bottom_navigation_home,
      style: TextStyle(fontSize: 12),
    ),
  )),

正确写法 #

首先在父级BottomNavigationBar上统一配置标签样式：

BottomNavigationBar(
  // 保留原有配置：currentIndex、onTap、backgroundColor等
  unselectedLabelStyle: const TextStyle(fontSize: 12),
  selectedLabelStyle: const TextStyle(fontSize: 12),
  items: [
    BottomNavigationBarItem(
      icon: Icon(Icons.home), // 保留原有的图标配置
      label: AppLocalizations.of(context).main_screen_bottom_navigation_home,
    ),
    // 其余所有BottomNavigationBarItem都按同样规则，把title替换为label即可
  ]
)

额外排查提示 #

• 写代码时如果对组件参数存疑，可以把光标悬浮在组件名上，查看当前SDK版本下的组件构造函数参数列表，避免照搬过时教程的旧API写法
• 如果需要高度自定义的导航项布局（比如自定义标签的边距、特殊交互），官方提供的BottomNavigationBar灵活性不足，可以替换为支持自定义Widget item的第三方导航组件实现

内容的提问来源于stack exchange，提问作者A Nagraj Chauhan