React Native初始化报错：Android SDK 33.0.0未被检测到

一、验证环境变量实际生效状态 #

• 关闭所有已打开的命令行终端（PowerShell、CMD等），重新打开管理员权限的终端
• 执行以下命令确认环境变量读取是否正确：

  echo %ANDROID_HOME%
  echo %PATH%
  

  确保ANDROID_HOME输出路径与SDK实际安装路径完全一致（比如C:\Users\你的用户名\AppData\Local\Android\Sdk），且PATH中包含%ANDROID_HOME%\platform-tools、%ANDROID_HOME%\tools、%ANDROID_HOME%\tools\bin

二、确认SDK 33.0.0完整组件安装 #

打开Android Studio的SDK Manager：

• 切换到SDK Platforms标签，勾选Android 13 (Tiramisu)（对应SDK 33），展开右侧Show Package Details，确认Android SDK Platform 33已安装
• 切换到SDK Tools标签，勾选Show Package Details，确认Android SDK Build-Tools 33.0.0、适配33版本的Android SDK Platform-Tools已安装

三、配置项目local.properties文件 #

在项目根目录的android文件夹下（若不存在则手动创建）新建local.properties文件，添加内容：

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

注意路径中的反斜杠需写成双反斜杠，或用正斜杠替代。

四、重置React Native Doctor缓存后重新检测 #

在管理员终端执行：

npx react-native doctor --reset-cache
npx react-native doctor

五、通过Android Studio同步项目配置 #

1. 打开Android Studio，选择Open导入项目根目录下的android文件夹
2. 等待Gradle自动同步完成，若提示安装缺失组件则按提示完成
3. 同步结束后回到终端再次运行npx react-native doctor

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