Android Studio修改build.gradle.kts后重新索引已排除C++文件夹

Android Studio在执行Gradle同步时，会完全基于Gradle插件的配置自动重建.iml文件——这意味着你手动通过IDE标记的排除规则、手动修改.iml添加的配置，都会被Gradle生成的新配置覆盖。这不是操作失误，是IDE与Gradle协作的既定逻辑：.iml是IDE依赖Gradle配置生成的临时产物，而非手动维护的配置文件。

你尝试的三种方案失效的具体原因：

• 修改.iml文件：Gradle同步时会直接重写整个文件，手动添加的排除规则会被清空
• IDEA Gradle插件的excludeDirs：未针对Android模块做适配，被Android Gradle插件的优先级覆盖
• 设置.iml只读：会导致Gradle同步失败（插件需要写入.iml更新项目结构），且无法阻止IDE重新扫描目录

方案1：通过Android Gradle插件配置排除（最可靠） #

在模块的build.gradle.kts中，通过sourceSets配置将binary/jni从所有源码集中排除，Gradle同步时会自动告知IDE跳过该目录的索引：

android {
    sourceSets {
        main {
            // 排除主源码集中的binary/jni目录
            java.exclude("**/binary/jni/**")
            // 如果该目录包含资源文件，同步排除资源索引
            // resources.exclude("**/binary/jni/**")
        }
        // 若有debug、release等其他源码集，同步添加排除规则
        debug {
            java.exclude("**/binary/jni/**")
        }
    }
}

方案2：配合IDEA插件强制排除索引 #

如果方案1效果不佳，在模块的build.gradle.kts中添加IDEA插件配置，明确指定排除目录，确保IDE索引时强制执行：

plugins {
    id("idea")
}

idea {
    module {
        // 直接指定要排除的目录路径（可根据项目结构调整为绝对路径或相对路径）
        excludeDirs.add(file("binary/jni"))
    }
}

同步Gradle后，IDE会自动应用该规则，不会被后续同步覆盖。

方案3：临时规避（针对疑似IDE Bug） #

如果上述方案仍无效（符合你遇到的疑似Bug场景），可以尝试：

• 关闭Settings → Build, Execution, Deployment → Gradle → General中的**"Automatically sync files to project structure"**选项，修改build.gradle.kts后手动执行同步，同步完成后立即重新标记binary/jni为Excluded（此为临时方案，每次同步后需重复操作）
• 升级至Android Studio最新预览版，查看是否已修复该版本特有的索引Bug

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