VSCode 能运行 Flutter 项目仅当 flutter 命令已正确加入系统 PATH、Dart 和 Flutter 插件均全局启用、且项目在含 pubspec.yaml 的根目录打开——三者缺一不可;否则补全失效、断点不命中、flutter doctor 报红。
VSCode 能跑 Dart 程序,但能否跑 Flutter 项目,取决于
命令是否真正进系统 PATH、插件是否在用户级启用、项目是否在正确根目录打开——三者缺一不可。只装插件不配 SDK,和只配 SDK 不重启 VS Code,效果一样:补全失效、断点不命中、
报红。
flutter 命令必须终端能直接执行
VSCode 插件不读你的
或系统环境变量面板里的“用户变量”,它只认你当前 shell 启动时实际加载的 PATH。常见失败点:
macOS/Linux:解压路径含空格(如
)或中文,
后没验证
是否有输出
Windows:把
加进了“用户变量”Path,但没加进“系统变量”;或者加了却没彻底退出 VS Code(仅关窗口无效)
用
—— 它装的不是完整 SDK,
常卡在找不到 Dart SDK,且无法指定
验证方式:新开终端,运行
和
,看到全 ✅ 才算过关。VS Code 再重启一次。
Dart 和 Flutter 插件必须装对且全局启用
VSCode 扩展市场里搜 “Flutter”,会出现多个名字近似的插件。真正要装的只有两个,且顺序不能错:
先装
(发布者:Dart Code),不是 “Dart Support” 或 “Dart Snippets”
再装
(发布者:Flutter Team),它会自动启用
插件
装完后必须右键点击
插件 → “Install for all users”(Windows)或 “Install globally”(macOS),否则新建项目时分析器根本不会启动
装完重启 VS Code,打开任意
文件,右下角状态栏应显示类似
或
。不显示?说明插件没活过来,别往下走。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
项目必须在 pubspec.yaml 所在层打开
VSCode 的 Dart 分析器靠
定位项目上下文。开错目录,补全、跳转、热重载全失效:
不要打开父文件夹(如
),也不要打开子文件夹(如
)
必须用 VS Code 直接打开含
的那一级目录(如
)
新建项目后,立刻在 VS Code 终端里手动运行
(别点 GUI 按钮,它常静默失败)
等右下角状态栏从
变成
,此时才开始有补全和悬停提示
如果卡住,按
输入
强制刷新。
调试前必须检查 launch.json 的 request 类型
F5 启动后控制台只输出
就结束,断点完全不触发?大概率是
配错了:
字段必须是
,不是
字段必须是
,不是
或
确保
指向
,而非其他路径
Flutter 3.16+ + VSCode 1.84+ 默认开启
,旧项目若断点失效,可临时在设置中关闭该选项
真机或模拟器连不上?别急着改 VS Code 设置。先在终端跑
(Android)或
(iOS),设备链路不通,编辑器再配也没用。
flutterflutter doctor.zshrc/Users/John Doe/fluttersource ~/.zshrcwhich flutterflutter\binbrew install flutterflutter doctordart.flutterSdkPathflutter --versionflutter doctor -vDartFlutterDartDart.dartDart SDK 3.4.3Flutter SDK: /path/to/flutterpubspec.yaml~/projects/~/myapp/lib/pubspec.yaml~/myapp/flutter pub getRunning 'pub get'Analysis server readyCtrl+Shift+PDart: Restart Analysis ServerLaunching lib/main.dart on Chrome...launch.jsonrequest"launch""attach"type"dart""chrome""pwa-chrome"programlib/main.dartdart.previewLspadb devicesxcode-select --install