Flutter：传递StatefulWidget类参数时，使用labelName报错

问题根源 #

const InputDecoration 要求所有传入的参数必须是编译时常量，而你通过构造函数传入的widget.labelName是运行时才确定的动态值，不属于编译常量范畴，所以直接在const修饰的InputDecoration里引用它必然报错——这和你用final/var/late声明变量无关。

解决方案 #

直接去掉InputDecoration前面的const关键字，让它成为一个运行时实例，这样就能正常使用widget.labelName了。

示例代码 #

报错的原代码 #

class ContactField extends StatefulWidget {
  final String labelName;

  const ContactField({super.key, required this.labelName});

  @override
  State<ContactField> createState() => _ContactFieldState();
}

class _ContactFieldState extends State<ContactField> {
  @override
  Widget build(BuildContext context) {
    return TextField(
      decoration: const InputDecoration(
        labelText: widget.labelName, // 此处触发报错
      ),
    );
  }
}

修复后的代码 #

class ContactField extends StatefulWidget {
  final String labelName;

  const ContactField({super.key, required this.labelName});

  @override
  State<ContactField> createState() => _ContactFieldState();
}

class _ContactFieldState extends State<ContactField> {
  @override
  Widget build(BuildContext context) {
    return TextField(
      decoration: InputDecoration( // 移除const关键字
        labelText: widget.labelName,
      ),
    );
  }
}

额外优化建议 #

如果想保留部分静态属性的const优化（比如边框、图标这些固定不变的样式），可以把动态和静态部分拆分：

decoration: InputDecoration(
  labelText: widget.labelName,
  border: const OutlineInputBorder(), // 静态属性仍可使用const
  prefixIcon: const Icon(Icons.person),
),

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