Git命令行不可用而IDE可用，根本原因是IDE使用手动配置的绝对路径，而Shell未将Git路径加入$PATH；需用which git确认路径并修复PATH。
Git安装后命令行用不了，IDE里却显示已配置
常见现象是 git --version 在终端报“command not found”，但 IntelliJ 或 Eclipse 的 Git 设置页里能选到路径、甚至测试按钮显示“Success”。根本原因：IDE 读的是你手动填的绝对路径（比如 /usr/local/bin/git），而 Shell 没把该路径加进 $PATH。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先在终端运行
which git或command -v git，确认真实路径；如果没输出，说明 Git 没被 Shell 识别，得重装或修复 PATH - macOS 上通过 Homebrew 安装的 Git，默认路径是
/opt/homebrew/bin/git（Apple Silicon）或/usr/local/bin/git（Intel），不是/usr/bin/git - Windows 用户注意：Git for Windows 自带的 Bash 和 CMD 是两个环境，IDE 通常调用的是 Windows 版本，要确保勾选了安装时的 “Add Git to the system PATH” 选项
- IntelliJ 中的 Git 路径设置在
Settings > Version Control > Git > Path to Git executable，填进去的必须是可执行文件全路径，不能只写git
IDE 提交时提示 “No changes detected”，但 git status 明明有修改
本质是 IDE 没监听到文件系统变更，或者项目根目录和 Git 仓库根目录不一致。尤其多模块 Maven 项目，容易把子模块当独立工程打开，导致 IDE 认为“当前工程没被 Git 管理”。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 检查
.git文件夹是否在 IDEA 当前 Project 的最外层目录下；如果不是，关掉项目，从包含.git的父目录重新打开 - IDEA 右下角状态栏会显示当前 VCS 类型（如 Git），如果显示 “None”，说明未识别仓库，点它 → “Enable Version Control Integration” → 选 Git
- 某些编辑器插件（如 Lombok、MapStruct）生成的 class 或 target 目录可能被 IDE 自动排除，但它们不影响源码提交；真正影响的是
.gitignore里写的规则 —— 比如误加了src/**就会导致所有源文件不被追踪 - 执行
git check-ignore -v src/main/java/com/example/MyClass.java可验证某文件是否被忽略及由哪条规则导致
push 失败报错 refusing to update checked out branch
这是 Git 默认安全机制：远程仓库如果是普通克隆（非 bare 仓库），禁止直接 push 到当前检出分支（如 master）。Java 开发中常出现在自己搭的测试服务器上部署代码时，想用 push 触发自动更新，结果卡在这儿。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 生产环境远程仓库必须用 bare 仓库：
git clone --bare myproject.git，然后把hooks/post-receive配好，再 push 才安全 - 临时调试可关闭保护（仅限本地或可信内网）：
git config --bool core.receivepack true（在远程仓库目录下运行），但不推荐长期开启 - 更稳妥的做法是：本地 push 到一个中间 bare 仓库，再由该仓库通过 hook 同步到工作目录（
git --work-tree=/path/to/app --git-dir=/path/to/bare.git checkout -f） - 这个错误不会在 GitHub/GitLab 等平台出现，因为它们后端本身就是 bare + 权限管控，普通用户 push 不会直连工作目录
IDE 中 pull 后 Maven 依赖变红，但 mvn compile 没问题
现象是 IDEA 里所有 import 报红，Project Structure 中 Libraries 显示缺失，但命令行 mvn compile 成功。这说明 Maven 本身没问题，是 IDEA 没刷新项目元数据。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 右键项目 → “Maven > Reload project”，别只点 “Reload project”（那是 Gradle 的）
- 检查
pom.xml是否有 profile 激活逻辑，比如<activebydefault>false</activebydefault>，而 IDEA 默认不激活任何 profile，导致依赖没加载；可在Settings > Build > Maven > Importing勾选 “Import Maven projects automatically” 并填入需要激活的 profile 名（用逗号分隔） - IDEA 的 Maven 导入默认不下载 sources/javadoc，导致跳转失败；可在同一页勾选 “Download sources” 和 “Download documentation”
- 如果用了自定义
settings.xml，确认 IDEA 的 Maven 配置路径（Settings > Build > Maven > User settings file）指向正确位置，否则可能拉不到私有仓库依赖
Git 和 Java 工具链的耦合点其实很薄：Git 只管文件快照，IDE 和 Maven 各自解析元信息。最容易被忽略的是「IDE 对 Git 仓库边界的感知」和「Maven profile 的上下文隔离」——这两处一错，就会出现“命令行 OK，IDE 报红”这类看似玄学的问题。
