React Native报错：未能找到Build Tools，WebStorm无法修改build.gradle

作为同时用Android Studio和WebStorm开发的同行，我太懂这种跨工具配置踩坑的痛苦了！咱们先把问题根源理清楚：这个错误核心是项目依赖的Build Tools版本和本地Android SDK已安装版本不匹配，再加上WebStorm的SDK配置没和Android Studio同步，你之前可能还改错了不可编辑的自动生成文件。下面给你一步步解决：

1. 先确认本地真的装了对应Build Tools #

打开Android Studio，进入Settings > Appearance & Behavior > System Settings > Android SDK，切到SDK Tools标签，勾选Show Package Details，找到Android SDK Build-Tools，确认你想用来的26.0.2真的在已安装列表里——别光看版本号，有时候你以为装了其实没勾选安装包细节里的对应子版本。

2. 把WebStorm的Android SDK路径和Android Studio同步 #

WebStorm默认可能没自动读取Android Studio的SDK配置，得手动对齐：

• 打开WebStorm的File > Settings > Appearance & Behavior > System Settings > Android SDK
• 把SDK路径改成和Android Studio完全一致的路径（比如Windows上是C:\Users\你的用户名\AppData\Local\Android\Sdk，Mac上是~/Library/Android/sdk）
• 点击Apply保存，别漏了这一步！

3. 修改正确的build.gradle文件（别碰依赖包里的！） #

你之前修改的大概率是node_modules里React Native自带的build.gradle——这类文件是依赖包的一部分，WebStorm提示不可编辑是对的，改了也会被依赖更新覆盖。正确的修改位置是你项目根目录下的两个本地build.gradle文件：

• 打开android/build.gradle，找到buildscript里的ext代码块，把buildToolsVersion改成你确认已安装的版本：

  buildscript {
      ext {
          buildToolsVersion = "26.0.2" // 替换成你本地已装的版本号
          minSdkVersion = 16
          compileSdkVersion = 26
          targetSdkVersion = 26
      }
      // 其他代码不动
  }
  

• 再打开android/app/build.gradle，检查里面的buildToolsVersion是否和上面一致，如果有单独设置的话也改成相同版本。

4. 清缓存再重新构建 #

缓存是很多配置不生效的罪魁祸首，按顺序执行：

• 在WebStorm终端里，先进入项目根目录的android文件夹：cd android
• 执行清理命令：Mac/Linux用./gradlew clean，Windows用gradlew clean
• 回到项目根目录，运行npx react-native run-android重新启动项目

5. 终极兜底：强制指定Build Tools版本 #

如果以上步骤都没用，试试在项目根目录的gradle.properties文件里直接加全局配置：

android.buildToolsVersion=26.0.2

这样gradle构建时会强制用这个版本，避免读取其他地方的冲突配置。

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