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 版本号。











