React Native Android编译失败：cmake命令未被识别

问题概述 #

执行yarn run v1.22.19及react-native run-android构建Android应用时失败，核心错误提示：

'cmake' 未被识别为内部或外部命令，可运行的程序或批处理文件。

具体失败任务为:react-native:ReactAndroid:hermes-engine:configureBuildForHermes，说明构建Hermes引擎时需要CMake但系统未找到。

解决方案 #

方案1：通过Android Studio安装CMake（推荐） #

• 打开Android Studio，进入Tools > SDK Manager
• 切换到SDK Tools标签页，勾选CMake选项（RN 0.71.x建议选3.22.1及以上版本）
• 点击Apply完成安装，重启终端后重新执行构建命令

方案2：手动配置CMake环境变量 #

• 下载对应系统版本的CMake安装包，安装时勾选Add CMake to the system PATH for all users
• 若安装时未勾选环境变量，找到CMake安装目录下的bin文件夹（例：C:\Program Files\CMake\bin）
• 打开系统环境变量设置：右键此电脑 > 属性 > 高级系统设置 > 环境变量
• 在系统变量的Path中添加上述bin文件夹路径
• 重启所有终端，执行cmake --version验证配置成功，之后重新运行构建命令

方案3：临时禁用Hermes（应急使用） #

如果暂时无法安装CMake，可临时关闭Hermes引擎：

• 打开项目根目录下的android/app/build.gradle文件
• 找到project.ext.react配置块，修改enableHermes为false：

  project.ext.react = [
      enableHermes: false,
      // 其他原有配置...
  ]
  

• 删除android/app/src/main/assets目录下的index.android.bundle（若存在）
• 重新执行react-native run-android

内容的提问来源于stack exchange，提问作者Engr.Aftab Ufaq