Ubuntu 上调试 Flutter 项目的实用流程
一 环境准备与设备连接
- 安装 Flutter SDK 并配置环境变量，确保命令行可执行 flutter 命令。完成后执行 flutter doctor 检查环境依赖（如 Android SDK、Dart 等）是否齐全。若缺少组件，按提示安装。
- 连接 Android 设备（开启开发者选项与 USB 调试）或在 Android Studio 中创建并启动模拟器。
- 在项目根目录执行 flutter pub get 拉取依赖。
- 使用 flutter devices 确认设备/模拟器已被识别。
- 如需图形化调试，安装 Android Studio 并启用 Flutter/Dart 插件。
二 运行与断点调试
- 终端运行：使用 flutter run 启动应用；在调试模式下可使用 flutter run --debug 获取更完整的调试信息。
- IDE 调试：在 Android Studio 或 VS Code 中打开项目，选择目标设备后点击调试按钮，设置断点、单步执行、观察变量。
- 日志与控制台：运行时查看控制台输出；如需持续跟踪设备日志，使用 flutter logs。
- 代码级调试辅助：在关键路径插入 print 或 debugPrint（仅在调试模式输出），快速定位问题。
三 使用 DevTools 进行 UI 与性能分析
- 安装与启动：执行 flutter doctor --install-devtools 安装 DevTools；应用运行后，点击控制台中的 Flutter 标识或执行 flutter devtools 打开工具页面。
- 连接会话：在已运行的应用上使用 flutter attach 将 DevTools 附加到目标进程。
- 常用能力：
- Flutter Inspector：查看与排查组件树、布局约束、重绘问题。
- Performance：进行 CPU/内存 分析，定位卡顿与内存异常。
- Network：查看与排查网络请求。
- 其他：Debugger、Storage、Logging 等面板辅助定位问题。
四 测试驱动与静态分析
- 单元测试：在 pubspec.yaml 的 dev_dependencies 中添加 flutter_test，编写测试用例后用 flutter test 运行。
- 静态检查：使用 flutter analyze 发现潜在问题（如未使用变量、异常未处理等）。
- 质量保障：结合单元测试与静态分析，在调试前快速排除常见错误，提高定位效率。
五 常见问题与快速排查
- 设备未识别：重新插拔 USB、确认授权弹窗、在手机端开启 USB 调试，再次执行 flutter devices。
- 依赖或构建失败：在项目根目录执行 flutter pub get；必要时执行 flutter clean 后重试。
- 启动异常：在 main 函数中使用 try-catch 捕获启动逻辑错误并展示错误界面，便于定位初始化问题。
- 日志不足：使用 flutter logs 实时查看设备日志，结合断点与 DevTools 定位问题。
- 环境异常：运行 flutter doctor 逐项修复缺失或异常的依赖项。