adb命令不识别是因PATH未包含SDK的platform-tools目录；JDK错配导致tools.jar找不到，需用JDK 11并配置gradle.properties和VS Code Java运行时；真机调试需启用USB调试并授权，Windows需手动安装ADB驱动；settings.json须正确配置android.sdkPath等关键项。
Android SDK 安装后 adb 命令不识别
常见现象是终端输入 adb devices 报错 command not found 或 'adb' is not recognized，本质是系统 PATH 没包含 SDK 的 platform-tools 目录。
- 确认 SDK 安装路径（如 macOS/Linux 默认在
~/Library/Android/sdk，Windows 常在C:\Users\{user}\AppData\Local\Android\Sdk） - 把
platform-tools子目录加进系统 PATH：macOS/Linux 编辑~/.zshrc或~/.bash_profile，追加export PATH=$PATH:~/Library/Android/sdk/platform-tools；Windows 在「系统属性 → 环境变量」里编辑用户 PATH，新增完整路径（如C:\Users\Alice\AppData\Local\Android\Sdk\platform-tools） - 重启 VS Code 终端（不是仅关闭标签页，要完全退出再重开），否则旧 shell 环境不会加载新 PATH
VS Code 里运行 Android App 报错 Could not find tools.jar
这是 JDK 版本错配的典型表现：Android Gradle Plugin 7.0+ 要求 JDK 11，但 VS Code 可能默认用了系统自带的 JDK 8 或 JDK 17+（部分 AGP 对 JDK 17 支持不完整）。
- 下载并安装
jdk-11.0.21（LTS 版本，AGP 兼容性最稳），不要用系统预装 JDK - 在项目根目录下创建
gradle.properties，写入org.gradle.java.home=/path/to/jdk-11.0.21（macOS/Linux 路径如/Library/Java/JavaVirtualMachines/jdk-11.0.21.jdk/Contents/Home，Windows 如C:\Program Files\Java\jdk-11.0.21） - VS Code 中打开命令面板（
Ctrl+Shift+P），执行Java: Configure Java Runtime，手动指定该 JDK 11 路径，避免插件自动选错
使用 React Native 或 Flutter 时调试 Android 真机没反应
不是代码问题，大概率是 USB 调试权限或驱动没到位。VS Code 本身不处理设备连接，它依赖底层 adb 和系统驱动链路通畅。
- 手机开启「开发者选项」和「USB 调试」，连接电脑后，首次会弹窗提示「允许 USB 调试吗？」——必须点「确定」，勾选「始终允许」，否则 VS Code 启动调试时会卡住
- Windows 用户特别注意：如果设备管理器里显示「Android ADB Interface」带黄色感叹号，说明驱动缺失，别用第三方“一键驱动包”，直接去
Android SDK目录下的extras\google\usb_driver手动更新驱动 - 在终端跑
adb devices确认设备状态是device（不是unauthorized或空列表），只有这时 VS Code 的调试器才能识别到目标设备
settings.json 里该配哪些关键 Android 相关项
VS Code 自身不内置 Android 支持，靠插件（如 Android Development Tools、React Native Tools）读取配置。硬编码路径或开关错位会导致插件功能失效。
- 必须显式指定 SDK 路径：
"android.sdkPath": "/Users/me/Library/Android/sdk"（路径结尾不加斜杠） - 启用真机热重载需配：
"react-native-tools.runAndroidOnDevice": true（针对 React Native）或"flutter.emulatorName": "Pixel_4_API_30"（针对 Flutter） - 禁用自动构建可减少干扰：
"android.autoBuild": false，改用手动触发gradlew assembleDebug更可控
路径类配置一旦写错，插件通常静默失败，不会报错提示。建议每次改完 settings.json 后重启 VS Code，再看插件右下角状态栏是否显示 SDK 版本号。
