必须同时安装dart和flutter两个官方扩展、按顺序安装后彻底重启vs code,并手动配置dart.fluttersdkpath为flutter根目录绝对路径,否则无法启动调试、热重载和设备检测。

VS Code 要真正跑起 Flutter 项目,不是装了插件就完事——dart.flutterSdkPath 没配对、插件装错顺序、终端环境没继承,三者任一出错,你就会卡在“设备列表为空”“F5 报 No debug adapter found”“右键没有 Run 'main.dart'”这些地方,而且 flutter doctor -v 全绿也救不了。
为什么装了 Dart 和 Flutter 插件还是不识别 SDK?
VS Code 不读系统 PATH,也不自动探测 Flutter 安装位置。哪怕你在终端能执行 flutter --version,GUI 启动的 VS Code 可能完全看不到它。
- 必须手动配置
dart.flutterSdkPath:指向解压后的 Flutter 根目录(含bin/flutter),不是bin子目录 - macOS/Linux 示例:
"dart.flutterSdkPath":"/Users/you/development/flutter" - Windows 示例:
"dart.flutterSdkPath":"C:\src\flutter"(注意双反斜杠) - 改完后必须按
Ctrl+Shift+P(或Cmd+Shift+P)运行Flutter: Reload Window,Developer: Reload Window无效
插件只装 Dart 或只装 Flutter 都不行
两个插件是强依赖关系,但不能互相替代:Dart 插件负责语法高亮、类型检查;Flutter 插件才提供设备监听、热重载通道、调试器注册。少一个,状态栏右下角就不会显示 Flutter: v3.x,F5 直接失效。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 卸载所有非官方 Dart/Flutter 插件(如旧版
Dart单独插件、Flutter Snippets) - 先装
Dart(发布者:Dart-Code.dart-code),再装Flutter(同发布者) - 每次安装后,**关掉所有 VS Code 窗口,从系统启动器重新打开**——这是唯一可靠重启方式
- 打开任意
.dart文件,确认状态栏右下角出现类似Dart: v3.6.x和Flutter: v3.19.x的标识
验证是不是真能用,别信 flutter doctor
flutter doctor -v 只说明命令行环境 OK,不代表 VS Code 插件能调用它。真正有效的验证只有三步实操:
- 终端执行:
flutter create myapp && code myapp - 等待右下角状态栏出现设备选择器(如
Chrome (web-javascript)或iPhone 15 (iOS)) - 按
F5启动调试(不是在终端里flutter run),成功后左上角应弹出调试控制栏 - 在
main.dart的build()第一行打个断点,F5 启动后看是否命中
最容易被忽略的是:VS Code 内置终端可能没加载你的 shell 配置(比如 macOS 的 .zshrc 中设的 ANDROID_HOME 或 PATH)。如果 flutter doctor 在终端里绿,在 VS Code 里报 Android 工具链失败,先在内置终端里运行 echo $ANDROID_HOME 看是否为空——空就是 shell 环境没继承,得用 code --new-window 启动 VS Code(macOS)或检查系统级 PATH(Windows)。










