必须先安装Flutter SDK并配置PATH，再安装官方Flutter插件，启动模拟器并确保ADB连接正常，最后在项目根目录下调试以保障热重载与断点有效。
安装Flutter SDK并配置PATH
VSCode本身不自带Flutter运行时，必须先在系统级完成Flutter SDK安装和环境变量配置，否则后续所有插件和命令都会报错 Command "flutter" not found。
从官网下载对应平台的SDK压缩包（非exe/msi安装包），解压到无空格、无中文路径，例如 /Users/you/flutter 或 C:\src\flutter；然后将 flutter/bin 路径加入系统 PATH 环境变量。
- macOS/Linux：在
~/.zshrc或~/.bash_profile中添加export PATH="$PATH:/path/to/flutter/bin"，执行source ~/.zshrc - Windows：通过“系统属性→高级→环境变量”编辑系统PATH，重启终端或VSCode
- 验证：终端运行
flutter doctor，确保输出中没有红色叉号——注意它会提示Android Studio未安装或Xcode命令行工具缺失，这些是独立依赖，不是VSCode的问题
安装Dart与Flutter插件（非“Flutter for VS Code”）
VSCode扩展市场里搜“Flutter”会出现多个名称近似的插件，真正需要的是官方维护的 Dart Code 团队发布的 Flutter 插件（作者是 Dart-Code），它同时包含Dart和Flutter支持。另一个叫 Flutter for VS Code 的旧插件已废弃，装了反而可能冲突。
安装后重启VSCode，打开一个 .dart 文件或 pubspec.yaml，状态栏左下角应显示Flutter SDK路径，比如 Flutter SDK: /path/to/flutter。如果没显示，说明插件没读到PATH里的配置，需手动指定：
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Flutter: Set Flutter SDK Path - 选择你解压的
flutter目录根路径（不是bin子目录） - 插件会自动识别Dart SDK位置，无需单独配置
Android模拟器启动失败常见原因
运行 flutter run 或点击VSCode右上角 ▶️ 按钮时，如果卡在 Waiting for another flutter command to release the startup lock... 或直接报 No connected devices，大概率是模拟器没起来或ADB没连上。
不要依赖Android Studio自带的AVD Manager启动模拟器再切回VSCode——VSCode的Flutter插件默认只识别已运行且ADB可见的设备，但不主动拉起模拟器。正确做法是：
- 先用命令行启动：运行
emulator -list-avds查看已有设备名，再执行emulator -avd Pixel_4_API_33 -no-window -no-audio（加-no-window可后台运行） - 确认ADB连接：新开终端执行
adb devices，应看到类似emulator-5554 device的输出；若为offline，重启ADB：adb kill-server && adb start-server - iOS模拟器不能通过VSCode直接启动：需先在Xcode中运行一次
open -a Simulator，再用flutter run才能识别；且必须使用Intel Mac或Apple Silicon Mac上原生支持的iOS模拟器版本（如iOS 16.4+）
调试时热重载不生效或断点无效
热重载（Cmd+S 或 R）失败，或断点灰色不可用，通常不是代码问题，而是调试会话未正确绑定到运行中的Dart VM实例。
关键检查点：
- 确保当前打开的是Flutter项目根目录（含
pubspec.yaml），而不是子文件夹；VSCode靠这个文件定位工程，否则插件无法加载正确的launch config - 不要手动修改
.vscode/launch.json里的request类型——应为launch，不是attach；类型写错会导致调试器找不到VM服务地址 - 首次运行时，务必等控制台输出出现
Running with sound null safety和Syncing files to device...后再操作，过早触发热重载会失败 - 如果断点始终灰，尝试在
main.dart第一行加debugger();，运行后看是否停住；停不住说明调试通道根本没建立，此时检查Flutter SDK版本是否与插件兼容（如Flutter 3.22+ 需 Dart Code v3.70+）
模拟器网络权限、防火墙拦截、甚至Mac上Rosetta转译导致的ADB异常，都可能让设备列表为空——这些底层链路一旦断裂，VSCode插件再怎么配也无济于事。
