Flutter中ListView Builder使用TextEditingController列表报标识符错误

错误原因 #

你声明controller列表的写法违反Dart语法：不能在列表的[]内部声明变量（final _name = TextEditingController();属于变量声明语句，不能作为列表元素），这直接触发了“Expected to find an Identifier”错误。

正确写法 #

有两种规范方式创建TextEditingController列表：

方式一：直接在列表中初始化控制器实例

适合无需单独访问某个控制器的场景：

List<TextEditingController> controllers = [
  TextEditingController(),
  TextEditingController(),
  TextEditingController(),
];

方式二：先声明单独变量，再加入列表

适合后续需要单独操作某个控制器的场景：

final _numberController = TextEditingController();
final _emailController = TextEditingController();
final _passwordController = TextEditingController();

List<TextEditingController> controllers = [
  _numberController,
  _emailController,
  _passwordController,
];

完整修正代码 #

同时修正了邮箱输入格式化规则（允许@和.）、添加控制器销毁逻辑（避免内存泄漏）、用列表长度作为itemCount（提升灵活性）：

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

class ListViewBuilder extends StatefulWidget {
  const ListViewBuilder({super.key});

  @override
  State<ListViewBuilder> createState() => _ListViewBuilderState();
}

class _ListViewBuilderState extends State<ListViewBuilder> {
  final _formKey = GlobalKey<FormState>();
  List<String? Function(String?)> validators = [
    (value) {
      if (value == null || value.isEmpty) {
        return '请输入数字';
      }
      return null;
    },
    (value) {
      if (value == null || value.isEmpty) {
        return '请输入邮箱';
      }
      return null;
    },
    (value) {
      if (value == null || value.isEmpty) {
        return '请输入密码';
      }
      return null;
    },
  ];
  List<TextInputFormatter> formatters = [
    FilteringTextInputFormatter.digitsOnly,
    FilteringTextInputFormatter.allow(RegExp('[a-zA-Z@.]')),
    FilteringTextInputFormatter.deny(RegExp(r'[/\\]'))
  ];
  
  // 正确的控制器列表
  List<TextEditingController> controllers = [
    TextEditingController(),
    TextEditingController(),
    TextEditingController(),
  ];

  @override
  void dispose() {
    // 销毁所有控制器，防止内存泄漏
    for (var controller in controllers) {
      controller.dispose();
    }
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Form(
        key: _formKey,
        child: ListView.builder(
          itemCount: controllers.length,
          itemBuilder: (context, index) {
            return TextFormField(
              controller: controllers[index],
              validator: validators[index],
              inputFormatters: [formatters[index]],
              decoration: InputDecoration(
                hintText: index == 0 ? '数字' : index == 1 ? '邮箱' : '密码',
                border: const OutlineInputBorder(),
                margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
              ),
            );
          },
        ),
      ),
      floatingActionButton: FloatingActionButton(
        child: const Text('提交'),
        onPressed: () {
          if (_formKey.currentState!.validate()) {
            // 获取输入值示例
            final number = controllers[0].text;
            final email = controllers[1].text;
            final password = controllers[2].text;
            print('数字：$number，邮箱：$email，密码：$password');
            
            ScaffoldMessenger.of(context)
                .showSnackBar(const SnackBar(content: Text('数据处理中')));
          }
        },
      ),
    );
  }
}

额外注意事项 #

• 给列表指定具体类型（如List<TextEditingController>），避免动态类型带来的潜在错误。
• 在dispose方法中销毁所有TextEditingController，防止内存泄漏。
• 保证validators、formatters、controllers三个列表长度一致，避免ListView.builder访问时出现索引越界错误。

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