Java项目.gitignore需区分四类：编译产物（target/、build/、*/.class）、IDE元数据（.idea/、.vscode/）、本地配置（application-local.yml）、构建临时文件（BOOT-INF/、logs/）；已跟踪文件需git rm --cached手动取消跟踪。
Java项目里.gitignore该放哪些核心路径
Java项目不是把所有生成物都扔进.gitignore就完事，关键得区分「编译产物」「构建缓存」「IDE元数据」和「本地配置」四类。漏掉target/或build/会导致每次git status一堆红色文件；多加了src/main/java/这种源码目录，团队直接没法拉代码。
-
target/（Maven默认输出目录）必须忽略，Gradle项目则对应build/ -
**/*.class要加，但别只写*.class——嵌套包路径下com/example/Service.class不会被匹配 -
.idea/、.vscode/、.project这类IDE文件建议忽略，除非团队强制统一用某IDE且共享配置 -
application-local.yml或config/dev/这种含敏感配置的目录，必须忽略，不能靠“大家自觉不提交”
为什么mvn clean后还总冒出未跟踪文件
因为mvn clean只清target/，但IDE（如IntelliJ）会额外生成out/、.iml、*.iws等文件，而这些未必在.gitignore里。更隐蔽的是：如果文件已被Git跟踪过，后来才加进.gitignore，Git依然会继续监控它。
- 先运行
git ls-files --ignored确认哪些文件实际被忽略规则捕获 - 若发现本该忽略却显示为未跟踪，用
git check-ignore -v <code>path/to/file查哪条规则失效或没生效 - 已跟踪的文件需手动停用跟踪：
git rm --cached <code>target/（注意加--cached，否则物理删除） - IntelliJ用户记得关掉「Build project automatically」，否则改代码瞬间就生成新
.class，容易误提
Spring Boot项目特有的忽略项
Spring Boot自带打包插件，会额外产出BOOT-INF/结构、fat jar临时解压目录，还有Actuator端点暴露的/actuator/env可能导出的env.json之类调试文件。这些不是标准Java编译产物，但不忽略就会污染仓库。
-
**/spring-boot-*.jar忽略本地打包的可执行jar（注意通配符位置，spring-boot-*.jar不匹配myapp-0.1.0.jar） -
**/BOOT-INF/忽略解压后的启动结构（某些插件会临时展开） -
logs/和tmp/建议忽略，尤其当logging.file.name指向项目内相对路径时 - 别忽略
HELP.md或application.properties——它们是项目必需配置，忽略等于删功能
团队协作时.gitignore最容易被覆盖的坑
很多人把.gitignore当成个人配置，结果自己加了一行**/log/，别人拉代码后发现连src/test/resources/log4j2.xml都不见了。根本问题在于：Git不合并.gitignore，后提交的人会直接覆盖前人的修改。
立即学习“Java免费学习笔记（深入）”；
- 把
.gitignore放在项目根目录，且纳入版本控制——它本身就是项目契约的一部分 - 避免在
~/.gitignore_global里塞Java相关规则，全局规则对非Java项目是干扰 - CI流程中（如GitHub Actions）如果用
actions/checkout@v4，默认不检出.gitignore内容，得靠git status --ignored做校验步骤 - 新成员加入时，提醒ta运行一次
git clean -fdx（慎用！先git status确认），清理本地残留的未忽略文件
真正麻烦的不是写错一行规则，而是规则生效了但没人知道它正在悄悄跳过某个关键路径——比如resources/**被误加进忽略，导致application-test.yml永远提不到远程。动手前，先git status -uall看全量未跟踪文件，比背模板管用。
