vs code搜不到flutter插件，90%因插件市场被拦截或未识别官方插件；必须确认marketplace连接正常、安装dart-code发布的flutter插件（非“flutter for vs code”）、配置dart.fluttersdkpath指向sdk根目录（不含/bin）、重启vs code并验证flutter: run flutter doctor命令可用。
VS Code 里搜不到 Flutter 插件？先确认插件市场是否正常
不是插件不存在，而是 VS Code 默认插件源可能被拦截或响应慢。国内用户常见现象是搜索 flutter 后无结果、加载中卡住、或只显示“Dart”但不显示“Flutter”官方插件。
- 打开 VS Code，按
Cmd + Shift + X（macOS）或Ctrl + Shift + X（Windows/Linux）进入扩展面板 - 右下角检查是否显示“已连接到 Marketplace”，若显示“无法连接”或空白，说明网络不通
- 临时解决：在命令面板（
Cmd + Shift + P）输入Preferences: Open Settings (JSON)，手动添加配置："extensions.autoUpdate": true,<br>"extensions.experimental.affinity": {}，然后重启 VS Code - 更可靠方式：改用国内镜像源——在设置中搜索
Extensions: Auto Update关闭自动更新，再手动安装离线包（从https://flutter.cn/docs/get-started/install页面底部找“VS Code 插件下载链接”）
安装时选错插件？认准 publisher 是 “Dart Code”
搜索结果里会出现多个叫 “Flutter” 的插件，但只有 publisher 显示 Dart Code 的才是官方维护的、带完整调试和命令支持的版本。其他同名插件大概率是旧版、阉割版或第三方 fork。
- 点开插件详情页，看顶部 publisher 字段是否为
Dart Code（不是 “Flutter Team” 或 “Google Inc.”） - 安装后左侧边栏应出现
Flutter和Dart两个图标（不是仅一个） - 安装完必须重启 VS Code —— 不重启会导致
flutter: New Project命令不可用、Cmd + Shift + P搜不到任何 flutter 相关命令 - 如果重启后仍无反应，检查插件状态：右键插件 → “Disable” 再 “Enable”，或卸载重装（不要勾选“保留配置”）
装完插件却提示 “No Flutter SDK configured”？路径没对上
插件本身不带 SDK，它只是个“遥控器”。你得告诉它 Flutter SDK 在哪，否则所有命令（如 flutter: New Project）都会报错。
- 确保你已下载并解压 Flutter SDK（比如解压到
/Users/yourname/flutter或C:\src\flutter） - 在 VS Code 设置里搜索
flutter.sdk，找到Flutter: SDK Path配置项，填入 SDK 根目录（不是bin子目录！） - 验证方式：打开命令面板 → 输入
Flutter: Run Flutter Doctor，能执行且输出结果即表示路径正确 - 常见错误：把
/path/to/flutter/bin当成 SDK 路径填进去 —— 这会导致插件反复报错，且无法识别flutter命令
装完插件后 F5 调试失败？设备没选对或没启动
F5 启动失败不是插件问题，而是运行上下文缺失。VS Code 插件不会自动帮你开模拟器或连真机，它只负责调用 flutter run。
- 状态栏右下角必须显示一个可用设备，比如
iPhone 15 Pro (iOS)、Pixel 4 API 34 (Android)或Chrome (web-javascript) - 如果没有设备，点击状态栏设备名 → 选择 “Open iOS Simulator” 或 “Launch Android Emulator”，或插上真机并开启 USB 调试
- 首次运行前建议先终端执行一次
flutter devices，确认设备列表非空；若为空，说明设备未就绪，F5 必然失败 - Web 开发场景下，必须确保已安装 Chrome 浏览器，且未被其它进程占用端口（比如已有 Chrome 实例在运行）
/bin、设备必须手动选一次才能进调试流程。
