vscode配置flutter开发环境的核心前提是flutter命令全局可用且插件正确安装；需将flutter/bin加入系统path、仅安装dart和flutter两个官方插件、在项目根目录打开vscode、执行flutter pub get等待analysis server ready、确保launch.json中request为"launch"且type为"dart"。
VSCode 本身不带 Flutter 支持，装了插件却没补全、断点不命中、设备列表为空——90% 的问题出在 flutter 命令根本没进系统 PATH，或者插件压根没读到 SDK 根目录。
flutter 命令必须能在终端直接执行
这是整个链路的起点。VSCode 的 Dart 和 Flutter 插件不会帮你找 SDK，只认 PATH 里能敲出 flutter --version 的那个命令。
- Windows：把
flutter\bin加进「系统变量」里的Path（不是用户变量），重启 VS Code（不是重开窗口，是彻底退出再打开） - macOS/Linux：在
~/.zshrc末尾加export PATH="$PATH:/path/to/flutter/bin"，然后运行source ~/.zshrc - 验证方式：新开终端，执行
flutter doctor -v；看到一连串 ✅ 才算通过；如果报command not found，VSCode 重启也没用
Dart 和 Flutter 插件只装这两个，别贪多
扩展市场里名字带 “Flutter” 的插件有七八个，但只有两个是官方维护、且相互依赖的：
- 装
Dart（发布者：Dart-Code），不是 “Dart Support” 或其他仿名插件 - 再装
Flutter（发布者：Flutter Team），它会自动启用Dart插件 - 装完必须重启 VS Code；打开一个
.dart文件，右下角状态栏应显示类似Dart SDK 3.4.3和Flutter SDK: /path/to/flutter
新建项目后没补全、跳转失效，不是插件坏了
刚用 flutter create myapp 创建完项目，lib/main.dart 里写 Text( 却没提示——这不是插件失效，而是 Dart 分析器还没加载完项目上下文。
- 确认项目根目录有合法的
pubspec.yaml（name:后不能是中文或空格） - 在 VSCode 内置终端中手动运行
flutter pub get（别点 GUI 上那个“获取包”按钮，它常静默失败） - 等右下角状态栏出现
Analysis server ready，此时补全、跳转、悬停文档才会生效 - 如果卡住两分钟以上，按
Ctrl+Shift+P输入Dart: Restart Analysis Server强制刷新
调试时断点不命中，大概率是 launch.json 配错了
F5 启动后控制台只输出 Launching lib/main.dart on Chrome... 就结束，断点完全不触发——这是调试配置被默认设成了热重载模式，而非完整调试会话。
- 确保
.vscode/launch.json中request是"launch"，type是"dart" - 首次 F5 若没生成
launch.json，VSCode 会提示创建；选 “Dart & Flutter” 模板即可，别手动改错类型 - 不要在项目外层文件夹打开 VSCode；必须在含
pubspec.yaml的那层根目录打开，否则插件无法识别为 Flutter 项目
最容易被忽略的是：插件从不自动扫描 SDK 路径，也不会读取 shell 配置里的 PATH；它要么靠系统环境变量生效，要么靠你手动指定 dart.flutterSdkPath 指向 flutter 根目录（不是 bin 子目录）。路径里有空格、中文、云同步目录（OneDrive/iCloud），都会让这个识别直接失败。
