必须同时安装Dart和Flutter两个扩展，且先装Dart再装Flutter并彻底重启VSCode；还需在settings.json中正确配置dart.flutterSdkPath指向Flutter SDK根目录，否则无法调用flutter命令、识别设备或启用热重载。
必须同时安装 Dart 和 Flutter 两个扩展
只装 Dart 扩展，VSCode 就只能高亮语法、跳转定义，flutter run 命令不出现、设备列表为空、热重载按钮灰色——这不是你配错了，是根本没装对核心模块。
Flutter 扩展（发布者：Dart-Code）才是调度 CLI、连接设备、启动调试会话的“指挥官”，它依赖 Dart 扩展但不被替代。安装顺序和重启方式直接影响功能是否就位：
- 先在扩展市场搜
Dart Code，点 Install；等状态栏右下角显示 “Dart” 语言模式再继续 - 再搜
Flutter（确认发布者是 Dart-Code），点 Install - 关闭所有 VSCode 窗口，彻底退出进程（macOS 可 Cmd+Q，Windows 右键任务栏图标退出），再重新打开
- 打开任意
.dart文件，检查右下角是否显示设备名（如iPhone 15或Android SDK built for x86_64）
手动配置 dart.flutterSdkPath 绝对路径
VSCode 不继承系统 PATH，即使终端里 flutter doctor -v 全绿，VSCode 内部仍可能报 Flutter SDK not found。这是最常卡住的环节，路径错一位、多空格、用中文用户名都会失败。
正确做法是直接编辑 settings.json，填入 SDK 根目录（不是 /bin 子目录）：
- Cmd+Shift+P → 输入
Preferences: Open Settings (JSON) - 添加或修改这一行：
"dart.flutterSdkPath": "/Users/yourname/flutter"（macOS 示例，结尾不加/bin） - Windows 用户注意反斜杠要写成双反斜杠：
"dart.flutterSdkPath": "C:\src\flutter" - 保存后，Cmd+Shift+P → 运行
Flutter: Run Flutter Doctor，输出应与终端一致
验证是否真能用，别只看 flutter doctor
终端里 flutter doctor -v 全 ✅，只说明 CLI 工具链可用；VSCode 能不能真正跑项目，得看它自己能否加载 Dart 分析服务器、识别设备、触发热重载。
快速验证三件事：
- Cmd+Shift+P → 输入
Flutter: New Project是否可选？不可选 = Flutter 扩展未激活或路径错误 - 打开一个已有 Flutter 项目，状态栏右下角是否显示设备名？不显示 = 设备未被识别或插件未连上 SDK
- 按
F5启动调试，是否弹出选择设备窗口？弹不出 = 插件未完成初始化，常见于未重启 VSCode 或路径含空格/中文
Mac 上还要额外配 Xcode 命令行工具
即使 Flutter 插件和 SDK 都配好了，iOS 模拟器在 VSCode 里仍可能不出现，因为 Flutter 插件需要调用 xcodebuild 和 simctl。
必须执行这三步：
- 从 Mac App Store 安装最新版
Xcode - 首次启动 Xcode，进
Preferences → Locations，在Command Line Tools下拉菜单中选中已安装版本 - 终端执行：
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer - 再执行：
sudo xcodebuild -runFirstLaunch授权并初始化组件
做完这些，VSCode 的设备下拉菜单里才会列出 iOS 模拟器选项。漏掉任一环，flutter devices 终端里能看到，VSCode 里就是空白。
