IDEA中Git配置错误、中文乱码、Lombok文件误提交及分支切换编译失败等问题，根源在于Git路径未正确配置、编码未设UTF-8、.gitignore未生效或IDE缓存与Git状态不同步，需针对性清理与配置。
IDEA 里 Git 路径配不对，git 命令直接报错
IDEA 启动时找不到 git，或者点击 Commit 提示 “Cannot run program ‘git’: error=2, No such file or directory”，本质是它压根没连上你系统装好的 Git 可执行文件。
实操建议：
- 打开 Settings > Version Control > Git，检查 Path to Git executable 是否指向了真实路径（macOS/Linux 通常是 /usr/bin/git 或 /opt/homebrew/bin/git；Windows 是类似 C:\Program Files\Git\bin\git.exe）
- 不要依赖 IDEA 自动探测——它常会漏掉 Homebrew 或 Scoop 安装的 Git
- 如果用的是 Windows + WSL Git，别填 WSL 路径（如 /home/xxx/git），IDEA 不认，得用 Windows 下的 Git for Windows
提交时中文乱码，git commit 日志全是问号
这不是 IDEA 界面问题，而是 Git 本身对 commit message 编码的默认行为在 Windows 或某些终端下不兼容 UTF-8。
实操建议：
- 在终端运行：git config --global core.quotepath false（关掉路径转义）
- 再执行：git config --global i18n.commitencoding utf-8 和 git config --global i18n.logoutputencoding utf-8
- 如果项目已存在乱码提交，仅改配置无效；后续新 commit 才会正常，旧记录需手动重写（不推荐轻动）
- IDEA 的 Terminal 控制台也要确认编码设为 UTF-8（Settings > Editor > Color Scheme > Console Font > Use color scheme font 关闭后手动选 UTF-8 字体）
Java 项目用了 Lombok，git status 却总显示 target/ 下一堆 class 文件被修改
这是 .gitignore 没生效或忽略规则写错的典型表现。Lombok 编译生成的字节码不该进版本库，但 IDEA 有时会把 target/ 目录误标为“已添加”。
实操建议：
- 检查项目根目录下的 .gitignore 是否包含这三行：/target/、/out/、**/*.class
- 如果已存在但不生效，可能是这些文件之前被 git add 过：运行 git rm -r --cached target/ 清除缓存再提交
- IDEA 的 Local History 功能偶尔会干扰 git 状态判断，遇到怪异“已修改”但 diff 为空，先点右键 → Git > Repository > Refresh，再看是否还标红
切换分支后 Java 类编译失败，java: cannot find symbol
不是代码错了，是 IDEA 的编译输出路径（out/ 或 target/）和当前分支源码结构不匹配。比如 A 分支有 com.example.util.X，B 分支删了这个包，但 IDEA 还留着旧 class 文件，编译器就去 classpath 里翻出残骸来报错。
立即学习“Java免费学习笔记（深入）”；
实操建议：
- 切分支后第一时间执行：Build > Clean and Rebuild Project（不是 Build，是 Clean and Rebuild）
- 确保 Maven/Gradle 的 Generated Sources 路径没被手动加进 Source Root（右键目录 → Mark as > Excluded 检查）
- 如果用的是 Maven，确认 pom.xml 中 sourceDirectory 和 outputDirectory 没硬编码成绝对路径——这种写法会让不同分支共享同一输出目录，冲突根源
Git 集成最麻烦的从来不是配路径，而是那些“看起来没动但其实状态已脏”的边界情况：缓存没清干净、编码配置跨平台失效、IDE 缓存和 Git 状态不同步。多看一眼 git status 输出，比狂点 IDEA 的 Refresh 有用得多。
