Flutter创建ListView遇‘null不是string子类型’错误，热重载后消失

核心错误原因 #

1. Text组件嵌套导致类型不匹配：在setupFileList函数的ListTile的title属性中，错误地将Text组件作为另一个Text的参数传递。Text构造函数要求第一个参数是String类型，传入Text Widget会直接触发type 'null' is not a subtype of 'string'错误（调试信息存在偏差，实际是Widget类型无法转为String）。
2. 语法括号不匹配：ListTile的subtitle字段后多了一个多余的}，导致代码结构解析异常，首次运行触发错误，热重载可能临时修复了解析状态，但问题根源未解决。
3. 未定义的_isEmpty变量：redundaneShow函数中使用的_isEmpty变量未在State类中声明初始化，可能引发空值问题。

修正后的代码 #

1. 修复setupFileList函数 #

Widget setupFileList(BuildContext context) {
  late Widget mainReturn;
  final _showList = SingleChildScrollView(
    child: Column(
      children: [
        ListView.separated(
          shrinkWrap: true,
          separatorBuilder: (BuildContext context, int index) => const Divider(height: 1, color: Color.fromARGB(255,48, 48, 48)),
          itemBuilder: (BuildContext _context, int _index) {
            return GestureDetector(
              child: Container(              
                color: setupMainTheme,
                child: ListTile(
                  onTap: () {
                    // 点击事件逻辑
                  },
                  trailing: const Icon(Icons.arrow_right, color: Colors.grey),
                  title: Text(
                    _titleValues[_index],
                    style: const TextStyle(
                      color: Color.fromARGB(213, 255, 255, 255),
                    ),
                  ),
                  subtitle: const Text(
                    "Sub 1",
                    style: TextStyle(
                      color: Color.fromARGB(197, 255, 255, 255),
                      fontSize: 12.8
                    ),
                  ),
                ),
              ),
            );
          },
          itemCount: _titleValues.length,
        ),
      ],
    ),
  );

  mainReturn = _titleValues.isNotEmpty ? _showList : redundaneShow();
  return mainReturn;
}

2. 修复redundaneShow函数及补充变量定义 #

在State类中添加并初始化_isEmpty：

class _cakeHomeWidgetState extends State<cakeWidget> {
  BuildContext? dialogContext;
  bool _isEmpty = false;

  @override
  void initState() {
    super.initState();
    _isEmpty = _titleValues.isEmpty;
  }

  // 其他代码...
}

修正后的redundaneShow：

Widget redundaneShow() {
  return Center(
    child: Visibility(
      visible: _isEmpty,
      child: const Text(  
        "It's empty here..",
        style: TextStyle(
          fontWeight: FontWeight.bold,
          color: Color.fromARGB(248, 94, 93, 93),
          fontSize: 26
        ),
      ),
    ),
  );
}

3. 主State类括号修复 #

@override
Widget build(BuildContext context) {
  return Scaffold(
    backgroundColor: setupMainTheme,
    appBar: PreferredSize(
      preferredSize: const Size.fromHeight(58),
      child: AppBar(
        centerTitle: false,
        title: const Column(
          children: <Widget>[
            Text("☀️ Good morning",
              style: TextStyle(
                color: Color.fromARGB(255, 190, 190, 190),
                fontWeight: FontWeight.w700,
                fontSize: 20
              )
            ),
          ], 
        ),
        automaticallyImplyLeading: false,
        backgroundColor: setupMainTheme,
        shape: const RoundedRectangleBorder(
          borderRadius: BorderRadius.vertical(
            bottom: Radius.circular(12)
          ),
        ),
      ),
    ),
    body: setupFileList(context),
  );
}

额外建议 #

• 用late或明确类型声明变量，避免var带来的类型模糊问题。
• 列表为空判断优先用_titleValues.isEmpty，语义更清晰。
• 在initState中初始化_isEmpty，确保Widget构建时状态正确。

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