必须同时安装Dart和Flutter两个官方扩展,且按顺序安装后彻底重启VS Code,并手动配置dart.flutterSdkPath为Flutter SDK绝对路径,否则无法启动调试、热重载和设备检测。

VS Code 要真正跑起 Flutter 项目,光装 Dart 扩展完全没用——必须同时安装 Dart 和 Flutter 两个官方扩展,且顺序、路径、重启方式三者全对,缺一不可。
为什么只装 Dart 扩展就卡在“找不到设备”
单独装 Dart 后,VS Code 只能高亮语法、提示变量,但 flutter run 命令不出现、热重载按钮灰色、状态栏右下角不显示设备名(比如 iPhone 15 或 Chrome (web-javascript))。这是因为 Flutter 扩展才负责启动 flutter daemon、监听设备、处理热重载通道;它依赖 Dart 扩展,但不被其替代。
常见错误现象:
Command 'Flutter: Run Flutter Doctor' not found- 按
F5启动调试时提示No debug adapter found - 右键菜单里没有
Run 'main.dart'
插件安装顺序和重启方式不能省
VS Code 不会自动激活扩展间依赖,必须手动控制加载时机:
- 先在扩展市场搜
Dart,确认发布者是Dart-Code.dart-code,点 Install - 再搜
Flutter,同样认准发布者为Dart-Code.dart-code,点 Install - 每次安装后,**必须关闭所有 VS Code 窗口,从系统启动器重新打开**;
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),成功后左上角应出现调试控制栏 - 在
main.dart的build()方法第一行打个断点,刷新页面或触发热重载,确认能停住、变量可查看
最容易被忽略的是:路径里含中文用户名、空格、符号,或误填了 /bin 子目录——这些都会让 flutter daemon 启动失败,整个调试链路静默中断。


















