Dart Workspace Web项目调试器失效（断点变灰）排查求助

1. 确认编译模式与调试配置 #

• 必须确保当前运行的是Debug模式，Release/Profile模式会移除调试符号，断点必然失效：
  • Android Studio：检查运行配置是否为flutter run --debug
  • VS Code：查看.vscode/launch.json中是否设置"mode": "debug"
• 排查pubspec.yaml是否存在禁用调试符号的配置，比如flutter: build: release: strip-debug-info: true（Debug模式默认不生效，但需确认无冲突）

2. 验证SDK与IDE插件兼容性 #

• 确保Android Studio的Flutter/Dart插件为最新稳定版，或与当前Flutter 3.29.1版本兼容
• 执行flutter doctor修复所有环境问题，比如Android SDK组件缺失、许可证未同意等

3. 重置IDE调试关联配置 #

• Android Studio：
  1. 打开File > Invalidate Caches...，勾选Clear file system cache and local history后重启IDE
  2. 删除项目根目录的.dart_tool、.idea文件夹，重新打开项目
• VS Code：
  1. 备份.vscode/launch.json后删除整个.vscode文件夹，重新生成调试配置
  2. 打开命令面板（Ctrl+Shift+P），执行Dart: Restart Debug Server

4. 排查代码优化或混淆问题 #

• 确认未手动开启Debug模式的Dart混淆：检查build.yaml或混淆插件配置，Debug模式默认不混淆，但需排除误配置
• 验证断点所在代码是否为死代码：在断点前添加print('debug test')，运行后查看控制台是否输出，确认代码块是否会被执行

5. 检查调试器进程关联 #

• Android Studio：运行项目后，通过Run > Attach Debugger to Android Process选中当前Flutter应用的(debug)进程
• VS Code：查看调试控制台是否有Attached to process XXX提示，若无则执行Dart: Attach to Running Application手动关联进程

6. 测试空白项目验证环境 #

• 执行flutter create test_debug新建空白项目，在main.dart中添加断点运行：
  • 若断点正常命中，说明原项目配置或代码存在问题
  • 若同样失效，需重新安装Flutter/Dart SDK，排查全局环境问题

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