根本原因是PATH未生效或flutter未赋权，VS Code不自动读取shell配置；需正确配置系统PATH、赋予执行权限、指定SDK根目录、避免云同步路径，并重启VS Code实例。
Flutter SDK 装完但 flutter doctor 一直报错
根本原因是 PATH 没生效，或者装的是 zip 包但没运行 flutter.bat（Windows）或没给 flutter 加执行权限（macOS/Linux）。VS Code 不会自动读取你终端里 source 过的 profile。
- Windows：把
flutter\bin路径加到系统环境变量PATH，不是用户变量；重启 VS Code（不是重开窗口，是彻底退出再打开） - macOS/Linux：运行
chmod +x ~/flutter/bin/flutter，然后在~/.zshrc或~/.bash_profile里加export PATH="$PATH:~/flutter/bin"，再source ~/.zshrc，最后重启 VS Code - 别用
brew install flutter—— 它装的版本常滞后，且flutter doctor可能识别不到 Dart SDK 路径
VS Code 插件装了却提示 “No Flutter SDK configured”
这是插件找不到 SDK 根目录，不是路径写错了，而是它只认你手动指定的位置，不会自动扫描。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入Flutter: Change SDK，选中你解压后的flutter文件夹（不是flutter/bin） - 如果插件仍不认，检查该文件夹下是否存在
version文件和bin/flutter.bat（Win）或bin/flutter（Mac/Linux）——缺任何一个都会失败 - 别把 SDK 放在 OneDrive、iCloud 或带空格的路径里（比如
C:\Users\John Doe\flutter），插件解析会出问题
运行 flutter run 卡在 “Installing build/app/outputs/flutter-apk/app.apk…”
本质是设备连接或 ADB 权限问题，VS Code 的终端只是个壳，它跑的还是你本地的 ADB 环境。
- 先在终端里运行
adb devices，看有没有列出设备；没有就重插 USB、打开开发者模式、启用 USB 调试，iOS 则必须用 Xcode 首次信任设备 - Android 真机上出现 “INSTALL_FAILED_UPDATE_INCOMPATIBLE”，说明旧包签名不一致 —— 直接卸载原 App 再试，别指望热重载覆盖
- 模拟器启动慢？关掉 Hyper-V（Win）或开启硬件加速（Intel HAXM / Apple Virtualization Framework），否则
flutter run会卡 2 分钟以上
代码补全失效或跳转不到源码
Dart 插件依赖 .packages 或 .dart_tool/package_config.json 来定位库，而 Flutter 项目结构会让它误判根目录。
- 确保你在项目根目录（含
pubspec.yaml的那层）打开 VS Code，不要打开父文件夹或子文件夹 - 删掉项目下的
.dart_tool和.packages，然后运行flutter pub get重建依赖索引 - 如果跳转进
package:flutter/src/widgets/framework.dart显示 “Source not found”，说明 Flutter SDK 源码没下载 —— 运行flutter upgrade --force强制拉取完整源码包
Flutter 环境真正卡住的地方，从来不是“装什么”，而是路径权限、进程上下文、以及 VS Code 是否真正在用你认为它在用的那个 SDK。每次改完配置，务必关掉所有 VS Code 实例再重开。
