Android问题：未通过AndroidStudio打开前gradlew无法正常运行

这种情况我碰过好多次，核心原因是Android Studio会悄悄帮你完成构建环境的前置配置，但纯CLI环境下没有这些自动操作——你提交的.idea目录文件只是AS的本地UI/模块配置，和构建工具依赖、SDK路径这类关键配置完全不相关，所以提交了也没用。

为啥AS打开后就能正常构建？ #

AS启动项目时会自动做这几件事：

• 生成local.properties文件（这个文件默认在.gitignore里，不会被提交到Git），里面写死了你的Android SDK本地路径，gradlew就是靠这个找到SDK和对应构建工具的；
• 检查项目build.gradle里指定的buildToolsVersion、compileSdkVersion，如果本地没有就自动下载对应版本；
• 初始化Gradle的本地缓存，关联好环境变量。

而你直接用CLI跑gradlew build时，这些步骤都没执行，自然会报“缺少构建工具”。

不用开AS也能跑通CLI构建的解决办法 #

• 手动创建local.properties：在项目根目录新建这个文件，写入你的SDK路径，比如：

  # Mac/Linux示例
  sdk.dir=/Users/yourname/Library/Android/sdk
  # Windows示例（注意路径转义）
  sdk.dir=C:\\Users\\yourname\\AppData\\Local\\Android\\Sdk
  

• 提前安装所需构建工具：用SDK自带的sdkmanager命令安装项目指定的版本，比如项目要求buildToolsVersion "34.0.0"，就运行：

  # 先进入SDK目录下的tools/bin文件夹
  ./sdkmanager "build-tools;34.0.0" "platforms;android-34"
  

• 配置环境变量：把ANDROID_HOME（或ANDROID_SDK_ROOT）指向你的SDK目录，这样gradlew会自动读取这个变量，不用依赖local.properties。比如在Mac的.zshrc里添加：

  export ANDROID_HOME=/Users/yourname/Library/Android/sdk
  export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
  

做完这些操作，你再克隆全新项目直接跑gradlew build，应该就能正常工作了。

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