Mac下Android Studio扫描根目录卡死问题记录

环境信息

• 操作系统: macOS 15.5 (Apple M2芯片)
• Android Studio版本: Meerkat Feature Drop | 2024.3.2 Patch 1 (Build #AI-243.26053.27.2432.13536105, 2025年5月22日构建)

问题现象

在项目开发过程中，提示一个依赖外部头文件的cpp源文件需要同步，点击"Sync Now"同步后，Android Studio出现卡死现象。最初怀疑是内存不足导致，因为在出现"Low memory"提示后，我将Android Studio的内存分配调整为5GB，但问题依旧存在。

具体表现为：

1. 项目Project结构中出现根目录显示异常
2. 右下角持续显示"Updating indexes"状态且长时间无进展
3. 强制退出后，打开其他项目也变得异常缓慢

尝试的解决方案

初步处理

1. 重装Android Studio：完全卸载后重新安装
2. 清理相关缓存：

   rm -rf ~/Library/Caches/Google/AndroidStudio*
   rm -rf ~/Library/Application\ Support/Google/AndroidStudio*
   rm -rf ~/.gradle
   

关键发现

1. 删除原项目目录，创建全新空项目 → 恢复正常
2. 逐步添加项目文件回原位置：
   • 当添加包含C++代码的文件时，Android Studio提示：

     This file is not part of the project. 
     Please include it in the appropriate build file 
     (build.gradle, CMakeLists.txt or Android.mk etc.) 
     and sync the project
     

   • 如果此时不点击"Sync Now"，项目可以保持正常状态。一旦点击"Sync Now" → 问题立即复现
     

问题分析

1. 同步机制缺陷：Android Studio的同步功能在处理特定C++文件时可能存在bug
2. 索引过程异常：同步操作触发的索引过程可能导致IDE卡死
3. Native代码支持问题：对某些特殊C++配置的支持可能不够完善

解决方案与建议

避免立即同步：当看到"Sync Now"提示时，不要点击，只要确保所有构建文件(build.gradle/CMakeLists.txt)已正确配置即可。也不要通过菜单手动执行"File" → “Sync Project with Gradle Files”（亲测）。

总结

这个问题揭示了Android Studio在Native代码支持方面可能存在的同步机制缺陷。关键规避方法是避免使用自动弹出的"Sync Now"按钮。希望Google能尽快修复这个神奇（操蛋）的问题。