VSCode能完整支撑Flutter开发的前提是flutter命令全局可用、仅装Dart和Flutter两个官方插件、项目初始化后手动执行flutter pub get；任一缺失将导致补全失效、断点不命中或设备列表为空。
VSCode 能完整支撑 Flutter 开发，但前提是 flutter 命令必须全局可用、插件只装官方两个、项目初始化后必须手动触发 flutter pub get——缺任一环，补全失效、断点不命中、设备列表为空都是必然结果，不是配置“不够好”，而是基础链路根本没通。
flutter 命令进不了 PATH，VSCode 插件就等于没装
VSCode 的 Dart 和 Flutter 插件完全不关心你把 SDK 解压在哪，它们只认系统 PATH 里能直接敲出 flutter --version 的那个命令。Windows 改「系统变量」里的 Path，macOS/Linux 往 ~/.zshrc 末尾加 export PATH="$PATH:/path/to/flutter/bin"，然后 source ~/.zshrc。新开终端跑 flutter doctor -v，看到全 ✅ 才算过关。如果终端里能运行、VSCode 里报 Command "flutter" not found，Mac 用户请用 code --new-window 启动 VSCode；Windows 用户确认 PATH 是加在「系统变量」而非「用户变量」里。
只装 Dart 和 Flutter 两个插件，别碰其他“Flutter”名字的扩展
VSCode 扩展市场里搜 “Flutter”，会出现七八个名字带这个词的插件。真正需要且必须装的只有两个：
-
Dart（发布者：Dart Code） -
Flutter（发布者：Flutter Team）
装完必须重启 VSCode。打开一个 .dart 文件，右下角状态栏应显示类似 Dart SDK 3.4.3 或 Flutter SDK: /path/to/flutter。如果没显示，或点击调试按钮提示 No debug adapter found for flutter，不用查插件设置，直接回退检查 flutter 是否真在 PATH 里。
新建项目后补全失效？等 Analysis server ready，别信 GUI 按钮
用 flutter create myapp 或 VSCode 命令创建完项目，lib/main.dart 里写 Text( 却没提示，不是插件坏了，是 Dart 分析器还没加载完项目上下文。必须满足三个条件：
- 项目根目录有合法的
pubspec.yaml（name:后不能是中文或空格） - 在 VSCode 内置终端中手动运行
flutter pub get（GUI 上那个“获取包”按钮常静默失败） - 右下角状态栏出现
Analysis server ready—— 这个状态出现前，跳转、悬停、补全全部不可用
如果卡在 Running 'pub get' 超过两分钟，按 Ctrl+Shift+P 输入 Dart: Restart Analysis Server 强制刷新。
断点不触发？检查 launch.json 的 request 类型
F5 启动后控制台只输出 Launching lib/main.dart on Chrome 就结束，断点完全不命中，大概率是调试配置被设成了热重载模式，而非完整调试会话。打开 .vscode/launch.json，确认里面 request 字段值是 "launch"，且 type 是 "dart"。不要用 request: "attach" 或漏掉 type。如果没生成该文件，首次按 F5 时选 “Dart & Flutter” 模板，它会自动创建正确结构。另外，program 字段必须明确指向 lib/main.dart，不能留空或指向错误路径。
最常被忽略的一点：VSCode 终端和 GUI 启动方式读取的 shell 环境可能不一致，尤其 macOS 上 ~/.zshrc 配了 PATH，但 Dock 图标启动的 VSCode 根本看不到——这种隐性断层比插件配置错误更难排查。
