React Native项目中Android SDK未识别，run-android安装失败求助

核心问题排查与修复步骤 #

1. 确认环境变量实际生效 #

不要只依赖系统设置面板，直接在终端验证配置：

• 检查ANDROID_HOME路径：
  Linux/macOS执行：echo $ANDROID_HOME
  Windows执行：echo %ANDROID_HOME%
  输出需匹配你的Android SDK实际安装路径（比如macOS默认是/Users/xxx/Library/Android/sdk，Windows是C:\Users\xxx\AppData\Local\Android\Sdk）
• 检查PATH是否包含必要路径：
  执行echo $PATH（Linux/macOS）或echo %PATH%（Windows），确认包含：
  • $ANDROID_HOME/platform-tools
  • $ANDROID_HOME/cmdline-tools/latest/bin
• 注意：修改环境变量后必须重启终端（Windows可能需要重启系统），或执行source ~/.zshrc/source ~/.bash_profile（macOS/Linux）让配置立即生效。

2. 修复SDK命令行工具路径 #

React Native要求命令行工具必须放在cmdline-tools/latest目录下：

1. 打开Android Studio → SDK Manager → SDK Tools，确保已勾选**Android SDK Command-line Tools (latest)**并完成安装
2. 进入$ANDROID_HOME/cmdline-tools目录检查：
   • 如果只有tools文件夹，手动将其重命名为latest
   • 如果已有latest文件夹，确认内部包含bin目录及sdkmanager等工具

3. 给项目手动指定SDK路径 #

在React Native项目根目录创建local.properties文件，添加一行SDK路径配置：

sdk.dir=/你的/android/sdk/完整路径

Windows示例：

sdk.dir=C:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk

macOS示例：

sdk.dir=/Users/你的用户名/Library/Android/sdk

该文件会直接告知Gradle和React Native SDK位置，优先级高于系统环境变量。

4. 验证adb工具可用性 #

执行adb devices，如果能列出当前运行的模拟器/设备，说明platform-tools路径配置正确；若提示adb: command not found，检查PATH是否正确添加了platform-tools路径。

5. 清理缓存与构建文件 #

• 清除React Native缓存：npx react-native start --reset-cache
• 进入项目的android目录，执行构建清理：
  Linux/macOS：./gradlew clean
  Windows：gradlew clean
• 重新运行项目：npx react-native run-android

6. 确认Android Studio的SDK配置 #

打开Android Studio → File → Project Structure → SDK Location，确认：

• SDK路径与ANDROID_HOME配置一致
• 已安装对应版本的SDK Platform（比如React Native 0.7x系列需API 33或34）
• 已安装对应版本的Android SDK Build Tools

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