Mark Directory as Excluded 仅影响 IDEA 索引与代码辅助，不改变 Maven/Gradle 编译行为；需同步在构建脚本中排除（如 Gradle 的 sourceSets.exclude 或 Maven 的 maven-compiler-plugin 配置）才能真正避免编译。
为什么 Mark Directory as Excluded 后文件还在编译？
因为「Excluded」只影响 IDEA 的索引、代码补全和检查，不改变构建工具行为。Maven/Gradle 仍会按自己的配置扫描源码，pom.xml 或 build.gradle 里声明的 src/main/java 下任何子目录，只要没被构建脚本显式排除，就会参与编译。
- IDEA 的「Excluded」本质是告诉编辑器「别管这个目录」，不是给编译器下指令
- 常见错误：把测试用的 mock 数据目录或临时生成的
gen-src标为 Excluded，结果打包时仍被打进 jar - 真正生效需双管齐下：IDEA 排除 + 构建脚本排除
Gradle 项目怎么同步排除生成的源码目录？
比如你用 protobuf 插件在 build/generated/source/proto 下生成 Java 文件，不希望它被当作主源码编译两次（IDEA 自己扫一遍，Gradle 又扫一遍），就得在 build.gradle 里明确剔除：
sourceSets {
main {
java {
exclude 'generated/**'
// 或更精确：exclude 'generated/source/proto/**'
}
}
}
-
exclude是路径模式，支持**通配，但注意它只对当前 sourceSet 生效 - 如果该目录实际属于
generated-sources，应改用java.srcDirs -= 'build/generated/source/proto' - 改完必须执行
./gradlew build验证，仅刷新 IDEA 项目（Reload project）不够
Maven 项目里 Mark Directory as Excluded 和 <excludes></excludes> 冲突吗？
不冲突，但分工不同：IDEA 的操作只影响编辑体验；Maven 的 <excludes></excludes> 才控制编译和打包。如果你在 pom.xml 的 maven-compiler-plugin 里写了：
<configuration>
<excludes>
<exclude>**/temp/**</exclude>
</excludes>
</configuration>
- 这个
exclude会让 javac 跳过匹配的 .java 文件，但 IDEA 仍可能高亮报错（因它已索引过） - 此时建议顺手在 IDEA 里也右键
temp/→Mark Directory as Excluded，避免误跳转、误补全 - 注意 Maven 的
<excludes></excludes>不影响资源拷贝，如要跳过非 Java 文件，得配maven-resources-plugin
排除后发现 import 报红或者类找不到？
大概率是误把本该参与编译的目录标成了 Excluded，比如把 src/main/java/com/example/util 整个标掉，而不是只标其下的某个临时子目录。
- 检查是否误操作：右键目录 →
Mark Directory as→ 看当前状态是不是Excluded（灰色图标） - 恢复方法：右键同一目录 →
Mark Directory as→Unmark as Excluded - 更安全的做法：只对明确“非源码、非资源、非测试”的目录操作，例如
node_modules、.history、out/、自定义的drafts/ - IDEA 2023.2+ 对 Excluded 目录加了小锁图标，悬停能直接看到「This directory is excluded from compilation and indexing」，留意这个提示
真正麻烦的是那些被构建脚本动态生成、路径不固定、又需要被 IDE 识别的目录——这时候不能只靠 Mark Directory as Excluded，得结合 Generated Sources 标记或 Gradle 的 sourceSets 声明来处理。
