Flutter SDK安装后flutter doctor报错找不到Dart SDK,是因PATH未生效或VSCode未继承环境变量;需刷新shell配置、避免单独安装Dart SDK、确认channel为stable;国内用户需配置pub镜像源;Android模拟器需启用Host GPU并加入kvm组;VSCode调试需安装Dart与Flutter双插件,禁用debugExternalLibraries,右键main.dart启动调试。

Flutter SDK安装后flutter doctor报错找不到Dart SDK
VSCode本身不自带Dart SDK,它依赖Flutter SDK内置的Dart运行时。但flutter doctor报这个错,通常是因为PATH没刷进当前终端会话,或VSCode没继承系统环境变量。
实操建议:
- 在终端执行
which flutter确认路径,然后运行source ~/.zshrc(macOS)或source ~/.bashrc(Linux),Windows用户需重启VSCode或用“Developer Command Prompt”启动 - 不要单独下载独立Dart SDK——Flutter SDK里已包含匹配版本的
dart二进制,手动装反而引发版本冲突 - 检查
flutter --version输出是否含“Channel stable”,非stable分支可能缺少预编译Dart工具链
VSCode里新建Flutter项目后pub get卡住或超时
这是国内开发者最常遇到的问题:Dart包仓库https://pub.dev直连不稳定,但VSCode默认不读取系统HTTP代理或git config里的proxy设置。
实操建议:
- 在项目根目录运行:
flutter pub config --set publish-url https://pub.flutter-io.cn(国内镜像) - 同时设置环境变量:
export PUB_HOSTED_URL=https://pub.flutter-io.cn和export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn,并写入shell配置文件 - 别在VSCode内置终端里点“Get dependencies”按钮——先关掉所有终端,再用Cmd+Shift+P → “Flutter: New Project”,让向导自动触发
pub get
Android模拟器启动后flutter devices看不到设备
不是模拟器没开,而是Flutter没识别到ADB连接,常见于Android Studio模拟器未启用“Use Host GPU”或VSCode没权限访问/dev/kvm(Linux)。
实操建议:
- 在Android Studio中打开AVD Manager,编辑你的模拟器 → Show Advanced Settings → 勾选“Use Host GPU”和“Enable Device Frame”
- Linux用户必须确认当前用户在
kvm组:sudo usermod -aG kvm $USER,然后完全退出并重登桌面会话 - 避免用
flutter emulators --launch启动——它调用的是命令行版emulator,不加载图形驱动;改用Android Studio启动,或确保emulator -list-avds能列出设备后再运行flutter devices
VSCode调试时断点不生效,控制台只显示Running "lib/main.dart"...
本质是Dart插件没正确绑定到Flutter工程结构,或者launch.json配置了错误的入口路径。
实操建议:
- 确认已安装官方扩展:
Dart Code和Flutter(两个都要,缺一不可) - 不要手动创建
.vscode/launch.json——用Cmd+Shift+P → “Dart: Open Extension Settings”,搜索“debug”并关闭dart.debugExternalLibraries(它会让断点跳进Framework源码) - 右键
lib/main.dart→ “Debug Dart & Flutter”,而不是点顶部绿色三角形——后者会走默认launch配置,容易误绑到test/目录


















