VSCode点击“Start without debugging”无法运行Flutter项目求助
Flutter在VSCode中无法通过"Start without debugging"启动项目的排查方案
问题背景
此前可正常通过VSCode运行Flutter项目,数月未使用后,无论是旧项目还是新建的默认计数器项目,点击main.dart中的Start without debugging按钮时,VSCode底部仅短暂显示"Starting debug session..."提示后无反应,项目无法运行。问题窗口、输出窗口、调试控制台及终端均无报错,但在VSCode终端执行flutter run命令可正常运行项目。已正确配置Windows环境变量Path指向flutter/bin,网络正常。该问题在两台Windows设备(台式机Flutter 3.22.2、笔记本Flutter 3.16.5)上均出现。
当前VSCode settings.json配置
{ "workbench.startupEditor": "none", "github.gitAuthentication": false, "editor.mouseWheelZoom": true, "editor.wordWrapColumn": 90, "editor.formatOnSave": true, "editor.fontFamily": "\"JetBrains Mono\", \"Consolas\", \"Courier New\", monospace", "editor.fontLigatures": "calt", // "editor.fontSize": 11.5, // editor font 크기(JetBrains mono) "editor.fontSize": 12.2, // editor font 크기(JetBrains mono) "editor.tabSize": 3, "editor.guides.bracketPairs": true, "editor.suggestSelection": "first", "editor.bracketPairColorization.enabled": true, // 괄호별 색상 적용 "editor.inlineSuggest.enabled": true, "editor.stickyScroll.enabled": true, "editor.linkedEditing": true, "editor.codeActionsOnSave": { "source.fixAll": "explicit" }, "editor.language.colorizedBracketPairs": [], // "editor.renameOnType": true, "vsintellicode.modify.editor.suggestSelection": "automaticallyOverrodeDefaultValue", "files.autoGuessEncoding": true, "workbench.editor.highlightModifiedTabs": true, // 파일 수정시 탭 색상 변경 "workbench.colorCustomizations": { "tab.activeBackground": "#F0FFFF" // "tab.activeBackground": "#FAFAD2" }, "[dart]": { "editor.formatOnSave": true, "editor.formatOnType": true, "editor.rulers": [ 90 ], "editor.selectionHighlight": true, "editor.suggest.snippetsPreventQuickSuggestions": false, "editor.suggestSelection": "first", "editor.tabCompletion": "onlySnippets", "editor.wordBasedSuggestions": "off", }, "dart.warnWhenEditingFilesOutsideWorkspace": false, "dart.renameFilesWithClasses": "prompt", "dart.previewFlutterUiGuides": true, "dart.previewFlutterUiGuidesCustomTracking": true, "dart.openDevTools": "flutter", "dart-data-class-generator.useEquatable": true, "workbench.colorTheme": "Default Light Modern", "redhat.telemetry.enabled": true, "vs-kubernetes": { "vs-kubernetes.minikube-show-information-expiration": "2023-12-25T04:51:22.688Z" }, "dart.debugExternalPackageLibraries": true, "dart.debugSdkLibraries": false, "dart.flutterHotReloadOnSave": "allIfDirty", "git.openRepositoryInParentFolders": "never", "dart.shareDevToolsWithFlutter": true, }
排查方向
- 检查并更新VSCode的Dart/Flutter插件:更新到最新稳定版,若仍有问题,尝试回退到之前能正常工作的版本,插件更新可能引入兼容性冲突。
- 重置Dart相关配置:备份当前
settings.json后,删除所有dart.开头的配置项,重启VSCode测试是否恢复正常。 - 检查调试配置文件:查看项目根目录
.vscode/launch.json是否存在异常,若无则生成默认Flutter调试配置(通过调试面板的"create a launch.json file"选择Flutter模板)。 - 验证Flutter SDK完整性:执行
flutter doctor -v排查是否存在调试相关的依赖缺失或配置问题,即使flutter run正常,也可能影响调试启动。 - 确认VSCode终端环境:设置VSCode默认终端为系统原生Shell(PowerShell或Command Prompt),避免第三方终端导致环境变量传递异常。
- 排查插件冲突:暂时禁用除Dart/Flutter外的所有插件,测试是否能正常启动项目,逐步恢复插件定位冲突源。
- 清理VSCode缓存:删除Windows下的VSCode缓存目录(
%APPDATA%\Code\Cache和%APPDATA%\Code\CachedData),重启后测试。 - 检查运行权限:以管理员权限启动VSCode,避免调试进程因权限不足无法正常启动。
内容的提问来源于stack exchange,提问作者Jsmile
相关产品推荐
相关产品推荐

