VSCode装错插件或连不上模拟器，90%因混淆Dart/Flutter SDK职责及路径配置混乱；必须选用Dart-Code发布的官方Flutter插件，正确配置dart.flutterSdkPath并删除dart.sdkPath，同时确保环境变量、ADB连接和Xcode权限就绪。
VSCode 里装错插件或连不上模拟器，90% 是因为没分清 Dart SDK 和 Flutter SDK 的职责边界，以及插件路径配置混乱。直接装“Flutter for VS Code”这种废弃插件，或者手动配了 dart.sdkPath 却没删它，都会导致 package:flutter/material.dart 报红、断点不命中、pub get 失败。
Flutter 插件必须选 Dart-Code 团队发布的官方版本
VSCode 扩展市场搜 “Flutter”，会出现两个高相似度插件：
- ✅ 正确插件：名称是
Flutter，作者显示为Dart-Code（不是 “Flutter for VS Code”） - ❌ 废弃插件：
Flutter for VS Code，作者是 “flutter” 或空，已停止维护，与当前 Flutter SDK 不兼容
装错的典型症状：打开 pubspec.yaml 后状态栏不显示 Flutter SDK: /path/to/flutter，右键 main.dart 没有 “Run ‘main.dart’” 选项。
安装后务必重启 VSCode；如果仍不识别，用 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）执行 Flutter: Set Flutter SDK Path，指向你解压的 flutter 根目录（例如 /Users/yourname/development/flutter），不是 bin 子目录。
Android 模拟器启动后 flutter devices 看不到设备
这不是 VSCode 的问题，而是 ADB 连接未就绪。常见于以下三种情况：
- Android Studio 模拟器未启用
Use Host GPU（在 AVD Manager 编辑设备 → Show Advanced Settings → Graphics 设为Hardware - GLES 2.0） - Linux 用户未将当前用户加入
kvm组：sudo usermod -aG kvm $USER，然后重启系统 - 第三方模拟器（如夜神、雷电）需手动连接 ADB：
nox_adb.exe connect 127.0.0.1:62001（端口按实际模拟器文档查）
验证方式：终端运行 adb devices，应看到一行带 device 状态的输出；再运行 flutter devices，才可能显示对应模拟器 ID。VSCode 状态栏右下角只有在 flutter devices 有输出时才会出现可选设备。
iOS 模拟器在 VSCode 中无法启动或调试失败
Mac 上 Xcode 和模拟器本身能跑 ≠ VSCode 能调用它。关键卡点在命令行工具和权限链：
- 必须先运行
xcode-select --install安装命令行工具，否则flutter doctor会报红 - 首次连接 iOS 模拟器前，需在 Xcode 中打开项目
ios/Runner.xcworkspace，选中任意模拟器并点击运行一次——这步会自动信任开发者证书、生成必要配置文件 - VSCode 启动调试前，确保 Xcode 已退出（不要后台挂着），否则模拟器端口可能被占用
如果 VSCode 点击运行后报错 Could not build the application for the simulator，别急着重装，先关掉所有 Xcode 实例，再在终端执行 flutter clean && flutter run -d ios 看具体错误。多数时候是证书或 provisioning profile 未就绪，Xcode 图形界面比命令行更直观暴露这类问题。
pub get 卡住、依赖包导入报红、断点不生效
这些表象背后往往是一个配置冲突：你同时装了独立 dart-sdk 并手动设置了 dart.sdkPath，但又配置了 dart.flutterSdkPath。VSCode 的 Dart 插件会优先读 dart.sdkPath，一旦它指向一个不含 package:flutter 的纯 Dart SDK，整个 Flutter 项目就废了。
正确做法只保留一项：
- 在 VSCode 设置中搜索
dart.flutterSdkPath，填入 Flutter SDK 根路径（如/Users/yourname/development/flutter） - 把
dart.sdkPath这项设置**彻底删掉**（不是留空，是删除该配置项） - 确认
dart.previewLsp为true，否则跳转定义、类型提示延迟严重
国内用户还要额外加两行环境变量到 ~/.zshrc 或 ~/.bashrc：
export PUB_HOSTED_URL=https://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
然后 source ~/.zshrc，再重启 VSCode。否则 pub get 会在 Downloading package_name... 卡死几分钟，且不会报错。
最容易被忽略的是：VSCode 启动方式。如果你从桌面图标或 Dock 直接点开 VSCode，它很可能没继承 shell 的 PATH 和环境变量。macOS 推荐用终端执行 code . 打开项目；Windows 用户建议用 “Developer Command Prompt for VS” 启动 VSCode，否则 which flutter 在 VSCode 内置终端里可能根本找不到命令。
