在Android Studio中模拟npx react-native init命令时遇编译任务依赖错误

1. 验证Android SDK环境变量 #

• 确认ANDROID_HOME环境变量指向正确的Android SDK根目录（Windows示例：C:\Users\你的用户名\AppData\Local\Android\Sdk；macOS/Linux示例：~/Library/Android/sdk）
• 检查PATH中已包含platform-tools和tools/bin目录：
  • Windows：%ANDROID_HOME%\platform-tools、%ANDROID_HOME%\tools\bin
  • macOS/Linux：$ANDROID_HOME/platform-tools、$ANDROID_HOME/tools/bin
• 终端执行echo $ANDROID_HOME（macOS/Linux）或echo %ANDROID_HOME%（Windows）验证路径有效性

2. 匹配Node.js版本 #

React Native要求使用LTS版本的Node.js（推荐18.x或20.x）：

• 执行node -v、npm -v查看当前版本
• 版本不符时，安装对应LTS版本，安装后重启终端

3. 清理缓存后重新初始化 #

• 执行npm cache clean --force清空npm缓存
• 删除已生成的AwesomeProject文件夹（如果存在）
• 执行npx react-native init AwesomeProject --verbose，通过--verbose参数获取详细错误日志，精准定位问题

4. 补全Android SDK组件 #

打开Android Studio的SDK Manager，确保安装以下组件：

• 对应React Native要求版本的Android SDK Platform（如API 33/34）
• 最新稳定版Android SDK Build-Tools
• 最新版Android SDK Command-line Tools
  安装完成后，执行sdkmanager --list确认组件安装状态

5. 修复目录权限（macOS/Linux） #

• 执行sudo chmod -R 755 $ANDROID_HOME，为Android SDK目录赋予完整读写执行权限
• 禁止使用sudo执行npx react-native init，避免权限冲突

6. 切换npm镜像（国内用户） #

国内网络环境可能导致依赖下载失败，切换到国内镜像：

npm config set registry https://registry.npmmirror.com/
npm config set disturl https://npmmirror.com/dist
npm config set react-native-cli_mirror https://npmmirror.com/mirrors/react-native-cli/

切换后重新执行初始化命令

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