vs code调试安卓真机需满足adb可用、真机已授权、vscode手动选中设备三条件；缺一则f5无响应，adb version验证路径，adb devices确认device状态，手机须勾选“始终允许”usb调试。
VS Code 不能直接写完代码点“运行”就装到手机上调试——它不内置 ADB、AVD、APK 签名或 Logcat 面板，所有构建、安装、日志查看都得靠你手动配通命令行链路。能跑起来的前提是：adb 可执行、gradlew 能成功打出 app-debug.apk、JDK 版本和 AGP 兼容、设备状态是 device 而非 offline。
adb devices 报 command not found 或列表为空
这不是 VS Code 的问题，是你终端根本没加载 platform-tools 路径。
- 确认 SDK 安装位置：
~/Library/Android/sdk（macOS）、%LOCALAPPDATA%\Android\Sdk（Windows）、~/Android/Sdk（Linux） - 把
platform-tools子目录加进 shell 配置文件（如~/.zshrc）：export PATH="$PATH:/your/sdk/path/platform-tools" - 必须完全退出 VS Code 再重开，否则新
PATH不生效；新开终端后运行adb version验证 - 真机连上后仍显示
offline？先执行adb kill-server && adb start-server，再拔插 USB 并确认手机弹出“允许 USB 调试”授权（部分厂商只弹一次，拒绝后需在开发者选项里手动撤销授权）
Java 补全失效或报 Could not find tools.jar
本质是 redhat.java 插件启动的语言服务器用了错的 JDK：AGP 7.0+ 强制要求 JDK 11，但插件可能自动选了系统自带的 JDK 8 或 JDK 17（后者对某些 AGP 版本支持不稳定）。
- 卸载或禁用系统预装 JDK，明确下载并安装
jdk-11.0.21（LTS，兼容性最稳） - 在项目根目录创建
gradle.properties，写死路径：org.gradle.java.home=/path/to/jdk-11.0.21 - VS Code 命令面板（
Cmd+Shift+P）运行Java: Configure Java Runtime，手动选中这个 JDK 11 - 检查
.vscode/settings.json是否含"java.configuration.updateBuildConfiguration": "interactive"，否则高版本语法（如var、record）补全会静默丢失
./gradlew assembleDebug 失败或生成的 APK 安装不了
常见失败点不在代码，而在签名配置或构建环境断连。
- 检查
app/build.gradle中android { signingConfigs { debug { } } }是否完整，缺失会导致生成无签名 APK，adb install直接拒绝 - 运行
./gradlew assembleDebug后，确认输出路径存在：app/build/outputs/apk/debug/app-debug.apk；若报Could not resolve all files for configuration ':app:debugRuntimeClasspath'，大概率是build.gradle里repositories没配镜像或网络被代理阻断 - 安装前先清旧包：
adb uninstall com.yourpackage.name，避免签名冲突；安装命令用adb install -r app/build/outputs/apk/debug/app-debug.apk（-r强制覆盖） - 别依赖 VS Code 的“运行任务”按钮——它只是封装了
gradlew调用，真正卡住时，必须回到终端看完整错误栈
模拟器启动不了，logcat 看不到日志
VS Code 插件无法启动或管理 AVD，emulator 可执行文件依赖 Android Studio 安装时生成的完整 SDK 组件（如 system-images、platforms），单独装 command-line tools 不够。
- 模拟器必须用 Android Studio 启动（哪怕最小化窗口），VS Code 只能连接已运行的设备
- 要查日志，别指望图形化 Logcat 面板：终端运行
adb logcat *:S ActivityManager:I MyApp:D，其中MyApp替换为你AndroidManifest.xml里的package名 - 如果
adb logcat卡住没输出，先adb shell ps | grep your.package.name确认进程是否真在运行；静默崩溃时，adb logcat -b crash才能看到崩溃堆栈 - VS Code 里装
Log Viewer插件只能读文件，不能替代实时流式日志；想过滤关键字，还是得靠adb logcat | grep "ERROR"
最易被忽略的一点：VS Code 的 settings.json 和 shell 的 PATH 是两套环境，改了系统变量不重启 VS Code 窗口，终端永远找不到 adb；JDK 配置写了 gradle.properties 但没在 VS Code 里手动指定运行时，Java 补全照样瘫痪。工具链是拼起来的，断一环，整个流程就卡在黑盒里。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
