Git 不忽略已跟踪的 .class 文件，需用 git rm -r --cached . 清除缓存；Maven 依赖问题源于未提交 pom.xml 或含 system 路径；IDEA 未识别 Git 根目录需在项目根目录打开；单元测试代码必须提交，但生成物要忽略。
Git 初始化失败：.gitignore 没生效，class 文件总被提交
Java 项目里 .gitignore 写了 target/ 和 bin/，但 git status 仍显示一堆 .class 或 MANIFEST.MF —— 很大概率是这些文件**已经被 Git 跟踪过**了。Git 不会自动忽略已跟踪的文件，哪怕它们后来匹配了 .gitignore 规则。
- 先确认是否已被跟踪：
git ls-files --cached | grep "\.class$" - 批量取消跟踪（不删本地文件）：
git rm -r --cached .，再git add .提交.gitignore更新 - 常见漏写项：
**/*.iml（IntelliJ）、.idea/、out/（Gradle 默认输出目录）、build/（Gradle/Maven 构建目录） - 别用通配符
*直接忽略所有.class：某些 IDE 生成的类文件路径含空格或特殊字符，会导致git rm失败；优先用目录级忽略更稳
Maven 项目 push 后别人拉不下来依赖
你本地能编译运行，但队友 clone 后执行 mvn compile 报 Could not resolve dependencies —— 这不是 Git 的问题，是 Maven 依赖没进版本库，但错误常被归咎于 Git 配置。
- Maven 的
pom.xml必须提交，但target/、lib/（手动放的 jar）、repository/（本地仓库）**绝对不能提交** - 检查是否有
<scope>system</scope>的依赖：这种依赖靠本地路径加载，换机器就断，应改用 Nexus 私服或mvn install:install-file安装到本地仓库后再提交 pom - 若用了
spring-boot-maven-plugin打包成 fat jar，确保src/main/resources/application*.yml没硬编码数据库密码等敏感信息；这类配置应由部署环境注入，而非进 Git
IDEA 提交时提示 “No Git root detected”，但命令行 git 正常
IntelliJ IDEA 显示项目未关联 Git，而终端里 git status 一切正常 —— 通常是 IDEA 没识别到 .git 目录位置，尤其在多模块 Maven 项目中容易出错。
- 检查项目根目录是否真有
.git文件夹：ls -a看一眼，别只信 IDEA 的 Project 视图 - 如果项目结构是
my-project/parent/pom.xml+my-project/module-a/src/，而你在module-a目录下开 IDEA，它会找不到上层.git；必须在my-project根目录打开整个项目 - IDEA 的 Git root 设置藏在
File → Project Structure → Project Settings → Version Control，右键目录可手动“Add”为 Git root - 别在
src/或target/下新建 IDEA 项目，这是最常见的人为误操作
Java 单元测试代码要不要进 Git？
要，但得看怎么组织。JUnit 测试类和资源文件属于项目源码的一部分，不提交等于放弃可重复验证的能力。
立即学习“Java免费学习笔记（深入）”；
- Maven 标准结构下，
src/test/java/和src/test/resources/**必须提交**；CI 流水线靠它们跑mvn test - 避免把测试用的临时文件（如
test-output/、surefire-reports/）提交；这些是 Surefire 插件生成的，加进.gitignore即可 - 如果测试依赖外部服务（DB、Redis），确保
@Test方法里用的是内存实现（H2、embedded-redis），而不是连真实环境；否则测试在别人机器上必然失败 - 注意
src/test/下的application-test.yml如果含 profile 激活逻辑，需确认它不会意外影响主配置加载顺序
Git 对 Java 项目来说，管的不是“代码能不能跑”，而是“别人拿到后能不能用同一套流程跑通”。路径、忽略规则、模块边界、测试上下文——这些细节一旦错位，协作成本就翻倍。尤其在混合使用 Maven/Gradle、IDEA/Eclipse、Linux/Windows 的团队里，一个没写全的 .gitignore 条目，可能让三个人花半天对齐环境。
