iOS真机通过VSCode调试Flutter时TextFormField键盘冻结崩溃及日志疑问

你好，针对你遇到的iOS真机在VSCode调试Flutter时出现的键盘冻结崩溃问题，以及日志里的相关疑问，我来逐一帮你分析和解答：

一、键盘冻结崩溃问题的核心原因分析 #

你的代码在Android、Xcode环境下运行正常，但VSCode连接调试时出现异常，大概率是VSCode的Flutter调试插件与iOS真机调试的兼容性问题，再加上你的代码里TextFormField的onChanged每次都调用setState，调试过程中频繁的状态更新会叠加VSCode调试监听的额外性能开销，导致设备和VSCode的资源占用过高，最终出现冻结甚至崩溃的情况。断开调试后没有了调试监听的额外负担，应用就能正常运行。

二、代码优化建议（减少不必要的性能消耗） #

你当前的TextFormField通过onChanged触发setState会导致整个页面频繁重建，这在调试时会放大性能问题。可以改用TextEditingController的addListener来监听文本变化，避免不必要的页面刷新，优化后的代码如下：

import 'package:flutter/material.dart';

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key}) : super(key: key);

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  bool _isExpanded = false;
  late TextEditingController textFieldController;

  @override
  void initState() {
    super.initState();
    textFieldController = TextEditingController();
    // 用controller的监听替代onChanged里的setState
    textFieldController.addListener(() {
      // 这里只处理需要的逻辑，不需要每次都调用setState
      // 如果确实需要更新UI，再按需调用
    });
  }

  @override
  void dispose() {
    textFieldController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Column(children: [
        Container(
            decoration:
                const BoxDecoration(color: Color.fromARGB(255, 70, 64, 61)),
            height: 90,
            width: 1200,
            child: Row(children: [
              ElevatedButton(
                  onPressed: () => setState(() {
                        _isExpanded = !_isExpanded;
                      }),
                  child: const Text(
                    'Click me',
                    style: TextStyle(color: Colors.white),
                  ))
            ])),
        Expanded(
            child: Stack(children: [
          const Positioned(
              top: 0,
              left: 0,
              child: SizedBox(
                height: 670,
                width: 1350,
              )),
          if (_isExpanded)
            Positioned(
                top: -30,
                left: 135,
                child: Column(children: [
                  Row(mainAxisAlignment: MainAxisAlignment.end, children: [
                    IconButton(
                        icon: const Icon(Icons.skip_previous),
                        onPressed: () => setState(() {
                              _isExpanded = false;
                            }))
                  ]),
                  Center(
                      child: SizedBox(
                    height: 200,
                    width: 400,
                    child: TextFormField(
                      // 移除onChanged里的setState
                      controller: textFieldController,
                      maxLines: 2,
                      style: const TextStyle(decorationColor: Colors.black),
                      decoration: const InputDecoration(
                          filled: true,
                          fillColor: Colors.white,
                          border: OutlineInputBorder(
                              borderRadius:
                                  BorderRadius.all(Radius.circular(4.0)))),
                    ),
                  ))
                ]))
        ]))
      ]),
    );
  }
}

三、关于调试日志中SubstituteLog的疑问 #

那些SubstituteLog的警告信息和你的Flutter应用本身无关，它们来自你iOS设备上安装的Flex3（一款iOS动态补丁工具）。Flex3尝试hook一些系统类的方法，但这些方法在当前运行环境中不存在，所以抛出了这些警告，不会导致你的应用崩溃，可以忽略它们。

四、解决调试冻结崩溃的可行方案 #

• 临时改用Xcode调试iOS真机，避开VSCode的兼容性问题；
• 更新VSCode的Flutter插件到最新版本，或者尝试降级到稳定版本；
• 关闭VSCode中不必要的调试功能，比如减少Debug Console的日志输出级别，降低资源占用；
• 清理Flutter缓存，运行命令：flutter clean，然后重新构建应用；
• 修复flutter doctor提示的环境变量问题：将/Users/pannam/flutter/bin添加到系统PATH的最前面，避免dart版本不一致引发的潜在问题。

备注：内容来源于stack exchange，提问作者Pannam