Gradle中排除文件需确认其是否在sourceSets.java.srcDirs中，优先用srcDirs -=移除非标准生成目录，exclude仅对已声明源路径生效且不跨sourceSet，动态条件排除应改用独立sourceSet或productFlavors。

Gradle Java项目里，想让某个文件或目录不参与编译，不能只靠 IDEA 的「Mark Directory as Excluded」——它只影响编辑器索引，对 Gradle 编译完全无效。

sourceSets.java.exclude 只对当前 sourceSet 生效

Gradle 的 exclude 是路径匹配规则，作用于 sourceSets 配置，不是全局开关。它只过滤被该 sourceSet 声明为源码的路径，比如 main 或 test 下的文件。

• exclude 'utils/DebugHelper.java' 会跳过 src/main/java/utils/DebugHelper.java，但不影响 src/test/java/ 下同名文件
• 路径模式支持 **，例如 exclude 'generated/**'，但注意它不会递归剔除子 sourceSet（如 integrationTest）中的匹配文件
• 如果文件实际在 build/generated/source/proto/ 这类非标准路径，且你没把它加进 java.srcDirs，那 exclude 根本不生效——得先确认它是否真被纳入了源集

排除生成代码：用 srcDirs -= 而不是 exclude

很多插件（如 protobuf、Lombok 注解处理器）会在 build/ 下生成 Java 源码，并通过 java.srcDirs += 'build/generated/...' 加入源集。这时若用 exclude，容易漏掉或误判；正确做法是直接移除整个目录：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

sourceSets {
    main {
        java {
            srcDirs -= 'build/generated/source/proto'
        }
    }
}

• 这行操作从源路径列表中彻底删除该目录，Gradle 后续扫描时根本不会看到里面任何 .java 文件
• 比 exclude 更干净，避免因路径匹配不精确导致残留编译
• 改完必须执行 ./gradlew build 验证，仅在 IDEA 里点 “Reload project” 不会刷新 Gradle 的源集快照

构建变体下条件化排除：别硬写 if-else

想让某类文件只在 debug 编译、release 跳过？Gradle 不支持运行时动态 exclude，强行写 if (project.hasProperty('skipUtil')) { ... } 极易引发构建缓存失效或 IDE 同步异常。

立即学习“Java免费学习笔记（深入）”；

• 更可靠的方式是把要排除的类挪到独立 sourceSet，比如 src/debug/java，然后在 release 构建时不加载它
• 或者用 productFlavors 分离逻辑：敏感工具类放在 src/internal/java，而 playStore flavor 的 sourceSets.playStore.java.srcDirs 不包含该路径
• 绝对不要在 exclude 中拼接系统属性或环境变量，Gradle 8.x+ 对这类动态配置的支持已大幅弱化，CI 上容易行为不一致

真正生效的关键永远是：确认该文件是否出现在 sourceSets.main.java.srcDirs 列表里，再决定用 srcDirs -= 还是 exclude。IDEA 的排除标记只是辅助，编译行为只听 Gradle 的源集定义。