vscode 开发 android 应用需手动配置 jdk、sdk、gradle 和插件，环境变量 path 未正确添加 platform-tools 导致 adb 找不到；jdk 版本不匹配（推荐 jdk 11）引发 java 补全失效；adb server 缓存或 usb 调试授权问题导致设备离线；gradle 构建失败多因签名缺失或设备未就绪；vscode 不提供 avd 和布局预览等 ide 功能。
VSCode 本身不能直接开发 Android 应用，它只是个编辑器；真正起作用的是你本地装好的 JDK、Android SDK、Gradle 和插件组合——配置错一个环节，adb 找不到、java 补全失效、assembleDebug 报 tools.jar 缺失，全是连锁反应。
adb devices 命令无效，VSCode 终端里始终报 “command not found”
这不是 VSCode 的问题，而是 shell 环境根本没加载 platform-tools 路径。Android Studio 能用不代表 VSCode 终端也能用——它读的是你当前终端的 PATH，不是 GUI 环境变量。
- 确认
platform-tools目录存在：macOS/Linux 通常是~/Library/Android/sdk/platform-tools，Windows 是%LOCALAPPDATA%\Android\Sdk\platform-tools - 把该路径追加进 shell 配置文件（如
~/.zshrc）：export PATH="$PATH:/your/path/to/platform-tools" - 必须重启 VSCode 的整个窗口（不是只关 Terminal 标签页），否则新
PATH不生效 - 在 VSCode 新建终端里运行
adb version验证，别信 Android Studio 里的成功状态
Java 补全失效、Ctrl+Space 没反应，或报 “Could not find tools.jar”
本质是 JDK 版本和语言服务器不匹配。Android Gradle Plugin 7.0+ 强制要求 JDK 11，但 VSCode 的 redhat.java 插件会按项目最低兼容版本启动，且它不会自动识别 gradle.properties 里的 org.gradle.java.home。
- 卸载系统自带 JDK 8 或 JDK 17（部分 AGP 对 JDK 17 支持不稳定），明确安装
jdk-11.0.21（LTS 最稳） - 在项目根目录创建
gradle.properties，写死路径：org.gradle.java.home=/path/to/jdk-11.0.21 - 在 VSCode 命令面板（Cmd+Shift+P）运行
Java: Configure Java Runtime，手动选中这个 JDK 11，而不是依赖自动探测 - 检查
.vscode/settings.json是否含"java.configuration.updateBuildConfiguration": "interactive"，否则语言服务器可能跳过高版本语法支持
真机连接显示 offline 或设备列表为空
不是线坏了，也不是手机没开开发者模式，而是 adb server 卡在旧设备缓存里，或者厂商 USB 调试弹窗被“永远拒绝”了——之后再插线也不会再弹。
- 先执行
adb kill-server && adb start-server清掉状态，再拔插 USB 线 - 手机进「设置 → 开发者选项」，关闭「USB 调试」→ 等几秒 → 再打开，看是否弹出“允许 USB 调试吗”授权框
- 华为/小米/OPPO 等需额外检查「USB 调试（安全设置）」是否开启，或关闭「MIUI 优化」「ColorOS 优化」
- 换 USB 接口或线缆——很多 Type-C 线仅支持充电，不走数据通道
Gradle 构建任务能识别但 installDebug 失败，提示签名错误或 no devices
VSCode 的 Gradle for Java 插件只负责调用命令，不处理签名配置和设备就绪逻辑。失败往往卡在两个地方：APK 没签名、或设备未真正就绪。
- 确保
app/build.gradle中signingConfigs已定义，且buildTypes.debug.signingConfig指向它（哪怕用 debug key） - 不要依赖插件自动选设备：先在终端跑
adb devices确认输出是device状态，不是unauthorized或空行 - 如果要用
installDebug，建议在.vscode/tasks.json里显式加上--no-daemon参数，避免 Gradle daemon 与 adb 状态不同步 - 更稳妥的做法是直接终端执行：
./gradlew assembleDebug && adb install -r app/build/outputs/apk/debug/app-debug.apk
最常被忽略的一点：VSCode 不管理 AVD、不提供布局预览、不集成 Layout Inspector。它只管代码和命令链路——所有“像 Android Studio”的功能，都得靠你手动配通底层工具链，少一个 export，就断在第一环。
