从Windows导入Android项目至Mac时Android Studio Gradle报错求助

我帮你梳理几个最常见的Windows转Mac Android项目Gradle构建失败的原因和解决办法，你可以逐一排查：

• 文件大小写不匹配问题
  Windows的文件系统是大小写不敏感的，但Mac（尤其是APFS格式）是大小写敏感的。比如你在Windows里创建了Utils.java，后来又改成utils.java，Windows会视为同一个文件，但Mac会认为是两个不同的文件，Gradle构建时就会出现找不到类的错误。
  解决步骤：

  1. 检查Git配置：Windows端设置git config --global core.autocrlf false，Mac端设置git config --global core.autocrlf input，避免Git自动转换大小写和换行符。
  2. 在项目根目录终端执行git ls-files --stage | grep -i <疑似大小写冲突的文件名>，找到冲突文件后统一文件名的大小写。

• Gradle缓存与本地配置残留
  Windows和Mac的Gradle缓存目录、Android SDK路径完全不同，项目里可能残留了Windows的配置信息，导致构建时路径错误。
  解决步骤：

  1. 删除项目根目录下的.gradle和build文件夹，这两个是本地缓存和构建产物，删除后不会影响项目源码。
  2. 检查项目根目录的local.properties文件，里面的sdk.dir路径是Windows的绝对路径（比如C:\Users\XXX\AppData\Local\Android\Sdk），直接删除这个文件，Mac上的Android Studio会自动识别本地SDK路径。
  3. 重新在终端执行./gradlew clean build触发构建。

• 换行符差异导致的脚本解析失败
  Windows用CRLF作为换行符，Mac用LF，Gradle脚本（.gradle文件）如果是CRLF格式，在Mac上执行时可能出现语法解析错误。
  解决步骤：

  1. 打开Android Studio，进入Preferences -> Editor -> Code Style -> Line Separators，选择Unix and macOS (\n)，然后右键项目根目录选择Reformat Code，统一所有脚本的换行符。
  2. 在项目根目录创建.gitattributes文件，添加内容*.gradle text eol=lf，确保后续Git提交的Gradle脚本始终用LF换行符。

• NDK/本地库的平台依赖问题
  如果项目用到了NDK编译的本地库（.so文件），Windows编译的库无法在Mac上运行，或者NDK路径配置不兼容。
  解决步骤：

  1. 删除src/main/jniLibs下所有Windows平台的架构文件夹（比如x86、x86_64），然后在Mac上重新编译NDK模块。
  2. 检查app/build.gradle中的NDK配置，确保ndkVersion是你Mac上已安装的版本，比如ndkVersion "25.2.9519653"。

• Gradle脚本权限不足
  Mac对可执行文件的权限要求严格，从Windows复制过来的gradlew脚本可能没有执行权限，导致无法启动Gradle进程。
  解决步骤：
  在项目根目录的终端执行命令：

  chmod +x gradlew
  

  给脚本添加可执行权限后，再重新运行构建命令。

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