intellij idea 不自带 git，需手动配置系统中已安装的 git 可执行路径；若未安装、路径错误（如指向 wsl 但项目不在 \wsl$ 下）、或环境变量未生效，idea 将提示“未检测到 git”，vcs 功能不可用。
Git 可执行路径没配对，git 命令就根本不会跑
IntelliJ IDEA 不自带 git，它只是调用你系统里装好的那个。如果 git 没装、路径填错、或指向了 WSL 但项目不在 \wsl$ 下，IDEA 就会卡在“未检测到 Git”提示里，连提交按钮都是灰色的。
检查方法：打开 Terminal 输入 git --version，能返回版本号才算真正可用。IDEA 里配置路径的位置是 Ctrl+Alt+S → Version Control → Git → Path to Git executable。Windows 上常见路径是 D:Program FilesGitingit.exe；用 WSL 的话必须手动填成类似 \wsl$ubuntuusringit，不能只写 git 或留空。
容易踩的坑：
-
Test按钮显示 success ≠ 实际能用——它只测能否启动进程，不校验权限或工作目录是否匹配 - WSL 路径配置后，项目必须通过
\wsl$打开才生效；直接打开 Windows 目录下的项目，IDEA 仍会尝试用 Windows 版git - 多 Git 环境（比如 Conda 自带的
git）容易导致git config --global和 IDEA 提交用的不是同一套配置
Commit 窗口里选中“未受版本控制的文件”，IDEA 会自动 git add
很多人以为“未受版本控制的文件”节点里的文件得先手动 git add 才能提交，其实不用。只要你在 Commit 工具窗口（Alt+0+0）里勾选它们，点 Commit，IDEA 就会在后台执行 git add + git commit 两步操作，一步到位。
但要注意：
- 如果文件已存在且被
.gitignore匹配，它根本不会出现在这个节点里——得先右键文件选Add to .gitignore取消忽略，或手动删掉.gitignore对应规则 - 勾选整个“未受版本控制的文件”节点时，IDEA 默认把所有子目录下新增文件都加进去；如果只想提交其中几个，得展开节点手动取消勾选
- 一旦提交成功，这些文件就进入暂存区并完成首次提交，后续修改会归入“更改”节点，不再属于“未受版本控制”
推送到远程失败，大概率是没设 remote 或分支没关联
Ctrl+Shift+K（Push）弹出窗口为空、提示“No configured push targets”，说明本地仓库还没告诉 IDEA 远程地址在哪。这不是网络问题，是 Git 层面的配置缺失。
补救步骤：
- 先确认远程地址是否存在：
git remote add origin <url></url>（URL 要带.git后缀） - 再关联当前分支到远程：
git branch --set-upstream-to=origin/main main（把main换成你实际用的分支名，如master） - 或者更简单：在 IDEA 中右键项目根目录 →
Git → Repository → Remotes → Add，填好名字（如origin）和 URL 即可
常见错误现象：
- Push 窗口里只有 “No commits to push”，但明明刚 Commit 过——其实是没关联分支，IDEA 不知道该推到哪个远程分支
- 点了 Push 后弹出认证失败，但账号密码没错——GitLab/GitHub 现在基本都要求用 Personal Access Token 替代密码，IDEA 的 GitLab 配置页（
Version Control → GitLab）里要提前填好 token
Revert 和 Reset 在 IDEA 里不是同一个菜单项，别点错
右键历史记录想撤回某次提交？Revert 是安全操作，生成一个反向新提交；Reset 是危险操作，直接改写历史。IDEA 把它们分开了：在 Show History 窗口里，右键某条记录，Revert Commit 是默认选项，而 Reset Current Branch to Here 藏在最底下，还带⚠️图标。
关键区别：
-
Revert：适合已推送到远程的提交，不会破坏他人历史，推荐日常使用 -
Reset：仅限本地未推送的提交，选Soft保留工作区和暂存区，Mixed（默认）清空暂存区但保留工作区，Hard全清——选错就真丢了代码 - IDEA 的
Reset不支持--force-with-lease，强推前必须切到 Terminal 手动执行git push --force-with-lease
复杂点在于：如果你在 Reset 后又做了新提交，再想恢复原状，就得靠 Reflog ——IDEA 的 Show History 默认不显示 reflog，得点右上角齿轮图标勾选 Show Reflog 才能看到那些“被删掉”的提交指针。
