Flutter中如何将对象作为参数传递到页面并在State类中访问

问题原因 #

你在_ChatScreenState里直接用chatModel.username初始化targetUsername会报错，核心原因是：State类的widget属性要等State对象和StatefulWidget完成关联后才会被赋值，在成员变量声明阶段，widget还未初始化，自然无法访问chatModel。

三种可行解法 #

解法1：late延迟初始化 + initState

这是最常用的方案，利用State生命周期方法initState（State初始化后第一个执行的方法，此时widget已完全可用）完成赋值：

class _ChatScreenState extends State<ChatScreen> {
  bool showEmoji = false;
  FocusNode focusNode = FocusNode();
  TextEditingController textEditController = TextEditingController();
  late String myUsername;
  late String targetUsername; // 用late声明，标记为延迟初始化

  @override
  void initState() {
    super.initState();
    // 此时widget已初始化，可安全访问chatModel
    targetUsername = widget.chatModel.username;
  }

  // 后续业务代码...
}

解法2：定义getter方法

如果不需要将值单独存储，只是想简化访问路径，可以直接定义一个getter，每次访问时直接从widget中读取：

class _ChatScreenState extends State<ChatScreen> {
  bool showEmoji = false;
  FocusNode focusNode = FocusNode();
  TextEditingController textEditController = TextEditingController();
  late String myUsername;

  // 通过getter直接返回widget的chatModel属性
  String get targetUsername => widget.chatModel.username;

  // 后续业务代码...
}

这种方式的优势是：如果父组件动态更新了chatModel，你能直接拿到最新值，无需手动同步数据。

解法3：应对参数动态更新的场景（可选）

如果ChatScreen的chatModel可能被父组件修改，除了initState，还需要重写didUpdateWidget方法，确保targetUsername能同步更新，避免数据不一致：

class _ChatScreenState extends State<ChatScreen> {
  bool showEmoji = false;
  FocusNode focusNode = FocusNode();
  TextEditingController textEditController = TextEditingController();
  late String myUsername;
  late String targetUsername;

  @override
  void initState() {
    super.initState();
    targetUsername = widget.chatModel.username;
  }

  @override
  void didUpdateWidget(covariant ChatScreen oldWidget) {
    super.didUpdateWidget(oldWidget);
    // 对比新旧widget的chatModel，发生变化则更新targetUsername
    if (oldWidget.chatModel != widget.chatModel) {
      targetUsername = widget.chatModel.username;
    }
  }

  // 后续业务代码...
}

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