Android Studio无法识别已安装的SDK Command-line Tools，求助解决方案

问题背景 #

在Windows 11电脑上学习React Native课程时，发现Android Studio中未识别到已安装的Android SDK Command-line Tools：

尝试安装该工具时，收到以下提示：

Packages to install: - Android SDK Command-line Tools (latest) (cmdline-tools;latest)


Preparing "Install Android SDK Command-line Tools (latest) (revision: 9.0)".
Package "com.android.repository.impl.generated.v2.RemotePackage@f2c9fb88" (cmdline-tools;latest) should be installed in 
"C:\Users\userid\AppData\Local\Android\Sdk\cmdline-tools\latest" but 
it already exists.
Installing in "C:\Users\userid\AppData\Local\Android\Sdk\cmdline-tools\latest-5" instead.
Downloading https://dl.google.com/android/repository/commandlinetools-win-9477386_latest.zip
"Install Android SDK Command-line Tools (latest) (revision: 9.0)" ready.
Installing Android SDK Command-line Tools (latest) in C:\Users\userid\AppData\Local\Android\Sdk\cmdline-tools\latest-5
"Install Android SDK Command-line Tools (latest) (revision: 9.0)" complete.
"Install Android SDK Command-line Tools (latest) (revision: 9.0)" finished.

已尝试安装5次，但Android Studio仍无法识别该工具。

咨询问题 #

1. Android Studio无法识别已安装的Android SDK的原因是什么？
2. 这会影响我调试React Native应用吗？
3. 是否可以安全删除C:\Users\userid\AppData\Local\Android\Sdk\cmdline-tools下的latest至latest-4目录？

命令提示符中查看的目录信息如下：

C:\>DIR C:\Users\userid\AppData\Local\Android\Sdk\cmdline-tools
 Volume in drive C is Windows
 Volume Serial Number is C2D6-EBDB

 Directory of C:\Users\userid\AppData\Local\Android\Sdk\cmdline-tools

03/14/2023  06:05 AM    <DIR>          .
03/13/2023  07:03 AM    <DIR>          ..
02/27/2023  06:59 AM    <DIR>          bin
03/09/2023  04:34 AM    <DIR>          latest
03/09/2023  04:35 AM    <DIR>          latest-2
03/13/2023  10:20 AM    <DIR>          latest-3
03/14/2023  06:04 AM    <DIR>          latest-4
03/14/2023  06:05 AM    <DIR>          latest-5
02/27/2023  06:59 AM    <DIR>          lib
03/09/2023  04:30 AM           109,836 NOTICE.txt
03/09/2023  04:30 AM                84 source.properties
               2 File(s)        109,920 bytes
               9 Dir(s)  623,560,048,640 bytes free

C:\>echo %ANDROID_HOME%
C:\Users\userid\AppData\Local\Android\Sdk

C:\>

问题解答 #

1. Android Studio无法识别已安装工具的原因 #

核心是目录结构不符合Android Studio的扫描规则：

• Studio要求cmdline-tools下的工具必须放在latest目录内，且latest下要直接包含bin、lib等核心子目录。但你的目录里bin、lib直接放在了cmdline-tools根目录，多次安装生成的latest、latest-*是独立目录，导致Studio找不到正确的工具路径。
• 第一次安装时可能因为权限不足、残留文件或手动修改过目录结构，导致安装程序无法覆盖原latest目录，只能创建带后缀的新目录，进而陷入重复安装的循环。
• 另外，即便ANDROID_HOME配置正确，如果PATH环境变量没加入%ANDROID_HOME%\cmdline-tools\latest\bin，也会导致Studio检测不到工具的可执行文件。

2. 对React Native调试的影响 #

会直接影响，大概率导致调试失败：

• React Native依赖Android SDK命令行工具（比如adb、sdkmanager）完成编译、打包、真机/模拟器部署等操作。如果Studio识别不到这些工具，RN的打包脚本会找不到依赖，直接抛出错误，比如提示找不到adb命令、无法获取SDK版本信息等。
• 就算手动配置了PATH，目录结构混乱也可能引发版本不匹配、模拟器启动失败、应用安装失败等兼容性问题。

3. 是否可以安全删除旧目录 #

完全可以安全删除：

• latest至latest-4都是重复安装产生的冗余文件，只有latest-5是完整的最新安装包，删除旧目录不会影响现有工具的使用。
• 删除后建议把latest-5重命名为latest，同时检查cmdline-tools根目录下的bin、lib等目录，若它们不属于latest目录可直接删除（正确结构应为cmdline-tools\latest\bin、cmdline-tools\latest\lib），这样Android Studio就能正常识别工具了。

内容的提问来源于stack exchange，提问作者Eric