如何正确迁移Android Studio项目目录以避免编译异常

迁移前必做清理 #

关闭Android Studio后，删除项目根目录下这些包含硬编码路径的自动生成文件：

• .idea 文件夹：存储Android Studio的项目配置、索引信息，会记录原路径
• build 文件夹：编译产物与缓存，包含大量路径相关数据
• 各模块下的build文件夹（如app/build）
• 项目根目录的.gradle文件夹（项目级缓存，非系统用户目录下的.gradle）
• local.properties 文件（若包含SDK/NDK绝对路径，迁移后可重新生成）

迁移执行步骤 #

1. 将清理后的整个项目目录复制/剪切到新路径或目标电脑
2. 打开Android Studio，选择「Open an existing project」，选中新路径下的项目根目录
3. 等待Android Studio重新索引项目、同步Gradle依赖（首次打开可能耗时，确保网络正常）
4. 若需要指定SDK/NDK路径，编辑自动生成的local.properties，优先使用环境变量（如${ANDROID_HOME}）或相对路径

问题根源 #

Android Studio的自动生成配置文件（如.idea/workspace.xml）和编译缓存会记录项目的绝对路径，直接移动项目但保留这些文件时，编译器会读取旧路径配置，导致找不到依赖文件。

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