Flutter真机调试失败主因是环境变量未生效或信任链中断，需验证ANDROID_HOME/JAVA_HOME、Xcode证书、手机开发者信任及VSCode终端配置。
Flutter SDK 安装后 flutter doctor 一直报 Android 工具链失败
根本原因是 Flutter 不认你本地装的 JDK 或 Android SDK 路径，不是它没检测到工具，而是环境变量没对上。Windows 和 macOS 行为还不一样——macOS 默认用 zsh，但 VSCode 终端可能跑在 bash 里，导致 flutter doctor 看不到你在 .zshrc 里配的 ANDROID_HOME。
- 检查
echo $ANDROID_HOME和echo $JAVA_HOME在 VSCode 内置终端是否输出正确路径；如果为空，就说明 shell 配置没生效 - Android Studio 安装完必须打开一次，让它自动下载并配置好 Command Line Tools（路径通常是
~/Library/Android/sdk/cmdline-tools/latest/binmacOS /%LOCALAPPDATA%\Android\Sdk\cmdline-tools\latest\binWindows） - 别用 Android Studio 自带的 JDK，统一用官网下载的 JDK 17（
flutter目前不兼容 JDK 21+），并确保java -version输出是 17.x - 在 VSCode 设置里关掉
terminal.integrated.defaultProfile.osx（或 win/linux 对应项），强制终端加载你的 shell 配置文件
VSCode 插件装了却提示 “No Flutter SDK configured”
这不是插件问题，是 VSCode 没找到 flutter 命令本身。哪怕你在终端能运行 flutter --version，VSCode 的 GUI 启动方式可能压根没读取你的 shell PATH。
- Mac 用户：从命令行执行
code --new-window启动 VSCode，而不是点击 Dock 图标——后者会丢失 shell 环境变量 - Windows 用户：确认系统环境变量 PATH 里包含
flutter\bin和android-sdk\platform-tools，不要只加在用户变量里，系统变量更稳 - VSCode 设置搜
dart.flutterSdkPath，手动填绝对路径，比如/Users/you/flutter或C:\src\flutter，比依赖 PATH 更可靠 - 重启 VSCode 后按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入Flutter: Run Flutter Doctor看实时反馈
iOS 真机调试卡在 “Installing and launching…” 或报 Could not find the built application bundle
Xcode 命令行工具、证书、设备信任三者只要一个没到位，就会静默失败。VSCode 里看不到详细日志，容易以为是 Flutter 问题。
- 先在终端进项目目录，执行
flutter build ios --no-codesign，成功后再试真机运行；如果这步失败，说明 Xcode 工程没生成好 - 打开
ios/Runner.xcworkspace，选中 Runner → Signing & Capabilities → Team 必须选个人 Apple ID（免费账户也行，但要勾上 Automatically manage signing） - 手机连电脑后，在 iPhone 设置 → 通用 → 设备管理（或描述文件与设备管理），信任你的开发者证书；这步漏了，App 根本不会启动
- VSCode 里运行时选的是
iPhone (your device name)，不是Chrome或模拟器——右下角状态栏会显示当前目标设备，点它可切换
Android 真机安装后闪退，logcat 显示 INSTALL_FAILED_UPDATE_INCOMPATIBLE
这是旧版本 App 还在手机上，签名不一致导致系统拒绝覆盖安装。Flutter 默认 debug 包用自签名，每次重装都算“新签名”，系统当它是另一个 App。
- 手动在手机设置里卸载旧版 App（别只删桌面图标），或者用命令
adb uninstall com.yourcompany.yourapp - 开发阶段别用
flutter run --release装真机，debug 模式才能热重载和看日志；release 包必须配签名，否则装不上 - 如果用了
flutter create --org com.example myapp，确保后续所有平台配置（AndroidapplicationId、iOSBundle Identifier）保持一致，否则多端运行时容易混淆包名 - 某些国产手机（华为、小米）需打开“USB 调试（安全设置）”和“安装未知来源应用”权限，这个开关藏得深，不是常规的开发者选项
真机调试最耗时间的从来不是配置步骤，而是某处信任链断了——Xcode 证书没点信任、手机没开安装权限、VSCode 没读到环境变量。建议每配一步，都在终端手动验证对应命令是否生效，别等 flutter run 失败了再回头查。
