根本原因是platform-tools未加入PATH，需手动添加至shell配置文件并重启VSCode终端；Java补全失效因语言服务器未正确识别JDK版本，须配置java.configuration.updateBuildConfiguration为interactive并手动选JDK；真机调试问题多源于adb服务状态异常或手机USB调试授权未通过，应先用adb命令逐层验证。
Android SDK安装后adb命令仍报“command not found”
根本原因不是SDK没装，而是platform-tools目录没加进系统PATH。VSCode本身不参与环境变量配置，它只读取你终端已有的PATH——所以即使Android Studio能用adb，VSCode终端里照样找不到。
- 确认
platform-tools路径存在：通常在~/Library/Android/sdk/platform-tools（macOS）、%LOCALAPPDATA%\Android\Sdk\platform-tools（Windows）或~/Android/Sdk/platform-tools（Linux） - 把该路径追加到shell配置文件（如
~/.zshrc或~/.bash_profile），写一行：export PATH="$PATH:/your/path/to/platform-tools" - 重启VSCode终端（不是关窗口，是执行
Terminal > New Terminal），再运行adb version验证 - 别依赖Android Studio自动配置：它可能只改了GUI启动时的环境，对VSCode终端无效
Java代码补全失效，java.home指向JDK但Ctrl+Space没反应
VSCode的Java支持靠redhat.java插件驱动，但它不会自动识别项目JDK版本，尤其当项目含gradle.properties或sourceCompatibility时，语言服务器会按最低兼容版本启动，导致高版本语法（如var、record）补全丢失。
- 检查项目根目录是否有
.vscode/settings.json，确保含："java.configuration.updateBuildConfiguration": "interactive" - 在VSCode命令面板（
Cmd+Shift+P）运行Java: Configure Classpath，手动选中正确的jdk-17或jdk-21（Android开发推荐JDK 17） - 如果用了Gradle，确认
build.gradle里sourceCompatibility = JavaVersion.VERSION_17已显式声明 - 别把
java.home设成JRE路径——必须是完整JDK（含bin/javac），否则语言服务器启动失败，补全直接静默退出
真机连接调试显示device offline或列表为空
不是USB线坏了，也不是手机没开开发者模式，而是adb服务进程卡在旧设备状态，或手机厂商USB调试授权弹窗被忽略过一次后不再出现。
- 先执行
adb kill-server && adb start-server清空状态，再拔插USB线 - 手机上点进「开发者选项」→ 关闭「USB调试」→ 再打开 → 看是否弹出“允许USB调试吗”授权框；若没弹，试试换USB接口或线缆（部分Type-C线仅充电）
- 华为/小米等厂商需额外开启「USB调试（安全设置）」或「MIUI优化」关闭，否则
adb devices始终看不到设备 - VSCode调试器依赖
adb识别设备，如果adb devices命令行里都列不出，VSCode的Run and Debug面板必然为空——别跳过这步验证
运行Debug Android App时卡在“Installing APK…”无响应
多数情况是APK签名冲突或adb install权限被拦截，VSCode调用的是底层adb命令，但错误日志被插件吞掉，只显示“Installing…”不动。
- 手动在终端运行
adb install -r your-app-debug.apk，看真实报错：Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE]说明签名不一致，需先adb uninstall com.yourpackage - 检查
android/app/build.gradle里debug { signingConfig signingConfigs.debug }是否启用——未配置会导致生成无签名APK，安装失败 - 某些国产手机（如OPPO、vivo）需在「设置→安全→更多安全设置」里打开「允许通过USB安装应用」，否则
adb install静默拒绝 - VSCode调试器默认使用
app:assembleDebug构建，但如果gradlew被代理或网络超时，它不会提示构建失败，而是卡住；可先在终端跑./gradlew assembleDebug确认APK生成成功
真机调试最耗时间的环节永远不在VSCode界面里，而在adb和手机系统之间那层看不见的握手——每次连不上，先抛开IDE，用adb命令逐层验证，比重装插件快十倍。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
