跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

VSCode配置Flutter开发环境 VSCode运行Dart程序方法

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

相关文章