Android Studio找不到运行器、无Run app选项且run-android报错

问题复现 #

从Git克隆的Android/React Native项目，Android Studio构建全程无报错但界面缺少「Run app」选项，执行run-android命令时返回以下错误：

Failed to launch emulator. Reason: No emulators found as an output of `emulator -list-avds`

可通过AVD Manager正常启动模拟器，网上通用解决方案无效，问题截图如下：

解决方案 #

1. 修复Android Studio无「Run app」选项问题 #

• 执行 File → Sync Project with Gradle Files，等待Gradle同步完成后查看顶部栏是否出现Run选项
• 若同步后仍无选项，执行 File → Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart，重启后等待Gradle全量同步完成即可
• 若上述操作无效，打开 File → Project Structure → Modules，确认app模块已被正确识别为Android应用模块，如模块丢失手动导入项目下的app目录即可

2. 修复run-android命令找不到模拟器问题 #

该问题核心原因是命令行环境未正确识别Android SDK路径，按以下步骤排查：

• 确认系统已配置ANDROID_HOME（或ANDROID_SDK_ROOT）环境变量，值为你的Android SDK安装目录
• 将SDK目录下的emulator、platform-tools、tools三个子目录全量加入系统PATH环境变量
• 配置完成后重启终端，执行emulator -list-avds验证是否能输出你创建的AVD列表，执行adb devices验证是否能识别到已启动的模拟器
• Windows用户注意不要将SDK安装在C:\Program Files这类带空格的目录下，会导致命令行路径解析异常
• 若已手动通过AVD Manager启动模拟器，可直接指定设备运行：
  先执行adb devices获取已启动设备的序列号，再执行npx react-native run-android --deviceId [你的设备序列号]即可跳过自动启动模拟器的步骤
• 苹果M系列芯片用户需确认下载的模拟器镜像为arm64架构，避免兼容问题

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