You need to enable JavaScript to run this app. Ubuntu系统下React Native识别不到已安装的Android Studio及SDK怎么办
优惠活动
大模型
产品
解决方案
定价
更多

Ubuntu系统下React Native识别不到已安装的Android Studio及SDK怎么办

Ubuntu 环境下 React Native Doctor 无法识别 Android 组件的排查指南

问题背景

你已在Ubuntu系统中正常安装Android Studio与Android SDK,二者可独立运行、功能正常,且已按照React Native官方指引完成所有前置依赖安装,在Android Studio内也已完成SDK Platforms、各类开发工具的合规配置,但执行npx react-native doctor时,工具无法识别到已安装的Android Studio与SDK。

核心原因与修正

最关键的问题出在环境变量的路径配置偏差上:

  • 你当前配置的ANDROID_HOME指向为$HOME/opt/Android/Sdk,该路径实际对应你个人用户家目录下的子目录(即/home/<你的登录用户名>/opt/Android/Sdk)
  • 但你实际的Android SDK物理存储路径为系统全局目录下的/opt/Android/Sdk,两个路径完全不重叠,直接导致React Native工具链扫描时找不到对应的SDK文件
    修正后的正确环境变量配置为:
export ANDROID_HOME=/opt/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools

注意:根据你当前使用的Shell类型,将上述配置写入对应用户配置文件:使用Bash则写入~/.bashrc,使用Zsh则写入~/.zshrc;写入完成后执行source <对应配置文件路径>让配置在当前终端立即生效,无需重启系统。

配置有效性验证

完成配置生效后,依次执行以下命令确认配置正确:

  • 执行echo $ANDROID_HOME,确认输出结果为/opt/Android/Sdk,不存在路径拼接错误
  • 执行adb --version,确认能正常输出Android Debug Bridge的版本信息,证明platform-tools路径已被正确加入全局PATH

其他可能的影响因素排查

  • 检查/opt/Android/Sdk目录的系统权限,确保当前登录用户对该目录拥有读、执行权限,避免因权限不足导致工具链无法扫描读取目录内容
  • 打开Android Studio的SDK管理面板,确认面板内关联的SDK根路径为/opt/Android/Sdk,而非AS首次启动时默认生成的家目录下的SDK路径,避免出现AS内部路径配置与系统全局配置不统一的问题
  • 不需要为Android Studio的安装路径(/opt/android-studio-ide/android-studio/bin)单独配置专属环境变量,React Native Doctor会在正确识别SDK路径后,自动扫描关联系统中已安装的Android Studio程序
    完成以上所有步骤后重新执行npx react-native doctor,即可正常完成Android组件的识别校验。

内容的提问来源于stack exchange,提问作者Ben Owen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 23:27:03