用途:当需要诊断并修复 Flutter 错误、崩溃或构建失败时使用该技能。其核心是一套可重复执行的协议:分类问题→收集上下文→追溯根因→实施最小修复→验证→防止复发。规则要求:不因一个 bug 就重写代码;在根因可查时不接受绕过方案;写任何代码前先用一句话说明根因。
主要能力:按错误模式分类,例如 RenderFlex 溢出归为布局问题,Null check operator 归为空安全,StateError、LateInitializationError 归为初始化,Gradle、CocoaPods、Firebase 初始化、MissingPluginException、PlatformException、Provider 生命周期、setState 在 dispose 后调用等各有对应类别与工具。
使用方式:先收集完整错误信息与堆栈、flutter --version、平台、触发方式、git diff;构建问题用 flutter doctor -v,运行时崩溃用 flutter run --verbose 2>&1 | head -200。随后按类别定位根因,例如布局用 Widget Inspector 与 Expanded/Flexible,空安全用空值保护,Riverpod 在 await 前缓存 ref,异步后检查 mounted。构建失败可执行 flutter clean && flutter pub get、cd android && ./gradlew clean --refresh-dependencies、cd ios && pod deintegrate && pod install 等。修复时只做最小改动。验证需通过 flutter analyze、flutter test,构建错误再执行 flutter build。最后补充回归测试,并把重复出现的模式记入 context-log-gotchas.md。
限制:资料未提供该技能的成本、收费方式、支持平台范围或性能承诺,暂未提供相关信息。