必须同时安装Dart和Flutter两个官方扩展,按顺序安装后彻底重启VS Code,并手动配置dart.flutterSdkPath为Flutter SDK绝对路径(不含bin),否则无法运行、调试或热重载;仅装Dart扩展只能语法高亮,无设备列表、热重载按钮灰色、F5报“No debug adapter found”。

VS Code 要能运行、调试、热重载 Dart 代码(尤其是 Flutter 项目),光装 Dart 插件完全不够——必须同时装 Dart 和 Flutter 两个扩展,且路径、顺序、重启方式三者全对,否则连 Flutter: Run Flutter Doctor 命令都找不到。
为什么只装 Dart 扩展就卡在“找不到设备”
单独安装 Dart 扩展后,VS Code 只能语法高亮、跳转定义、提示变量,但:
• flutter run 命令不出现
• 热重载按钮灰色不可点
• 状态栏右下角不显示设备(如 Chrome (web-javascript) 或 iPhone 15)
• 按 F5 提示 No debug adapter found
• 右键菜单没有 Run 'main.dart'
根本原因是:Flutter 扩展才负责启动 flutter daemon、监听设备连接、建立热重载通道、提供 Widget Inspector;它依赖 Dart 扩展,但不被其替代。
必须按顺序安装 Dart + Flutter 扩展并彻底重启
VS Code 不会自动激活扩展间依赖,必须手动控制加载时机:
- 先在扩展市场搜索
Dart Code,确认发布者是Dart-Code.dart-code,点击Install - 再搜
Flutter,同样认准发布者为Dart-Code.dart-code,点击Install - 每次安装后,必须关闭所有 VS Code 窗口,从系统启动器(不是 Dock / 开始菜单快捷方式)重新打开;
Developer: Reload Window无效 - 打开任意
.dart文件,确认状态栏右下角显示类似Dart: v3.6.x和Flutter: v3.19.x的字样
dart.flutterSdkPath 必须手动填绝对路径
VS Code 不继承系统 PATH,也不会自动探测 SDK 位置。填错路径是“终端里 flutter doctor 全绿,但 VS Code 里啥都不行”的最常见原因。
操作步骤:
- 打开设置(
Cmd+,或Ctrl+,),搜索dart.flutterSdkPath - 点击
Edit in settings.json,添加一行(注意结尾不加/bin):
"dart.flutterSdkPath": "/Users/yourname/development/flutter"
Windows 用户注意反斜杠要双写:
"dart.flutterSdkPath": "C:\src\flutter"
- 确保该路径下存在
bin/flutter(macOS/Linux)或bin/flutter.bat(Windows) - 保存后,按
Cmd+Shift+P运行Flutter: Run Flutter Doctor,输出应与终端一致
验证是否真能用:别只信 flutter doctor
flutter doctor -v 全 ✅ 只说明 CLI 就绪,不代表 VS Code 插件能调用它。真正有效的验证是这三步:
- 新建项目:
flutter create myapp && code myapp,等右下角出现设备选择器(如Chrome (web-javascript)) - 按
F5启动调试(不是终端里flutter run),成功后左上角应出现调试控制栏 - 修改代码保存,确认热重载立即生效(非刷新整个页面)
最容易被忽略的是:路径中含中文、空格、符号,或用了软链接(如 ~/flutter)——VS Code 无法解析这类路径,必须填完整绝对路径,一个字符都不能错。


















