已配置环境却检测不到Android SDK，React Native构建失败求助

以下是针对该问题的具体排查和解决步骤：

• 验证环境变量的准确性

  1. 确认ANDROID_HOME（或新版推荐的ANDROID_SDK_ROOT）环境变量指向SDK根目录，比如Windows下为C:\Users\<你的用户名>\AppData\Local\Android\Sdk，Mac/Linux下为~/Library/Android/sdk
  2. 检查系统PATH变量是否包含以下路径：
     • %ANDROID_HOME%\platform-tools（或对应系统的路径格式）
     • %ANDROID_HOME%\tools
     • %ANDROID_HOME%\cmdline-tools\latest\bin（若安装的是指定版本，可替换为%ANDROID_HOME%\cmdline-tools\<版本号>\bin）
  3. 在终端运行adb version，若能正常输出版本信息，说明platform-tools配置生效；运行echo %ANDROID_HOME%（Windows）或echo $ANDROID_HOME（Mac/Linux）确认SDK路径正确

• 调整Cmdline Tools目录结构
  新版Android Studio的Cmdline Tools默认安装在cmdline-tools\<版本号>目录下，React Native可能无法识别这种结构，需调整：

  1. 打开Android SDK Manager，找到已安装的Cmdline Tools，记录版本号
  2. 在SDK根目录的cmdline-tools文件夹下，创建latest子文件夹，将对应版本文件夹内的所有内容移动到latest中
  3. 确保环境变量的PATH指向cmdline-tools\latest\bin

• 强制指定SDK路径到项目
  在React Native项目根目录创建local.properties文件，添加SDK绝对路径：

  sdk.dir=C:\\Users\\YourUsername\\AppData\\Local\\Android\\Sdk
  

  运行npx react-native config，查看输出中的sdkPath是否与配置一致

• 处理虚拟化误判问题

  1. 打开任务管理器（Windows）或活动监视器（Mac），确认CPU虚拟化已启用
  2. 若使用HAXM，运行sc query intelhaxm（Windows）检查服务状态，未启动则执行sc start intelhaxm手动启动；Mac下可通过Android SDK Manager重新安装HAXM
  3. 若确认虚拟化已正常开启，可忽略react-native doctor的提示，直接尝试运行npx react-native run-android，该提示大概率是工具误判

• 清理React Native缓存
  执行以下命令重置缓存并重新构建：

  npx react-native start --reset-cache
  cd android && ./gradlew clean
  cd .. && npx react-native run-android
  

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