如何获取定义在类中的TextEditingController的取值？

一、TextEditingController取值为null问题排查 #

按优先级依次排查以下常见原因：

• 检查dispose生命周期执行时机：如果生成PDF的逻辑是异步执行，若异步逻辑还没跑完TextEditingController就已经被页面的dispose方法释放，此时取到的text就会为null。建议调整释放时机，确保PDF生成逻辑执行完成后再调用controller.dispose()。
• 检查controller绑定逻辑：每个TextField必须对应独立的TextEditingController实例，不能多输入框复用同一个实例；同时确认TextField的controller参数确实绑定了对应的实例，没有出现变量名写错的情况。
• 检查取值时机：如果在页面刚初始化、用户还未输入时就取值，拿到的会是空字符串而非null，可先打印controller.text的实际值和类型，区分空字符串和null的差异。
• 检查实例一致性：如果将TextEditingController存放到其他类或全局变量中，确认取值时用到的实例和绑定到TextField的是同一个实例，没有出现重复初始化覆盖原有实例的情况。

正确绑定与取值示例 #

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

  @override
  State<FormPage> createState() => _FormPageState();
}

class _FormPageState extends State<FormPage> {
  // 页面初始化阶段创建controller实例
  final TextEditingController nameController = TextEditingController();
  final TextEditingController idController = TextEditingController();

  Future<void> buildPdf() async {
    // 触发PDF生成时再取值
    final String userName = nameController.text;
    final String userId = idController.text;
    // 后续PDF生成逻辑
  }

  @override
  void dispose() {
    // 所有用到controller的逻辑执行完成后再释放
    nameController.dispose();
    idController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        TextField(controller: nameController, decoration: const InputDecoration(label: Text('用户名'))),
        TextField(controller: idController, decoration: const InputDecoration(label: Text('证件号'))),
        ElevatedButton(onPressed: buildPdf, child: const Text('生成PDF')),
      ],
    );
  }
}

二、跨文件类的初始化与属性获取 #

假设你在单独文件custom_model.dart中定义了如下类：

// custom_model.dart 文件内容
class PdfTemplate {
  final String title;
  final double margin;
  // 构造函数
  PdfTemplate({required this.title, this.margin = 20});

  // 自定义方法
  int getPageCount(int contentLength) {
    return (contentLength / 500).ceil();
  }
}

• 初始化方式：在需要使用该类的文件顶部导入对应文件后，直接调用构造函数创建实例即可

// 业务文件导入类
import 'custom_model.dart';

// 初始化实例
final PdfTemplate userPdfTemplate = PdfTemplate(title: '用户信息报告', margin: 15);

• 属性与方法获取：直接通过实例名.属性名/方法名调用即可

// 读取属性
final String pdfTitle = userPdfTemplate.title;
final double pdfMargin = userPdfTemplate.margin;
// 调用类方法
final int pageCount = userPdfTemplate.getPageCount(1200);

注意事项 #

• 不要在类定义文件中直接初始化依赖动态参数的实例，建议在业务逻辑用到时再初始化，或通过依赖注入的方式传递实例，避免出现实例不匹配的问题。
• 如果类属性为可变类型，修改属性时要确保操作的是同一个实例，不要重复创建新实例导致修改不生效。

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