Git插件启用需系统安装git且IDEA正确配置路径；git init后项目未显示在Local Changes中因.git不在项目根目录；Commit失败常因文件未暂存；Push认证失败须改用token或SSH。
Git 插件是否启用、git 命令能否被 IDEA 找到
IDEA 默认自带 Git 集成，但前提是系统已安装 git，且 IDEA 能定位到它的可执行路径。常见现象是点击 Commit 按钮没反应，或弹出 “Cannot run program ‘git’: error=2” 这类提示。
检查方式：打开 Settings → Version Control → Git，看 Path to Git executable 是否指向有效的 git（比如 macOS 上是 /usr/bin/git 或 /opt/homebrew/bin/git，Windows 上可能是 C:\Program Files\Git\bin\git.exe）。如果为空或路径错误，手动填入；不确定路径时，终端运行 which git（macOS/Linux）或 where git（Windows）确认。
- 不要依赖 IDEA 自动探测——它有时会漏掉 Homebrew 或 Scoop 安装的版本
- 如果用 GitHub CLI（
gh）或其他包装工具，别把它们的路径误填进这里，必须是原生git - 重启 IDEA 后再测试，插件状态不会热更新
git init 之后项目没出现在 Local Changes 列表
新建项目后执行了 git init，但 IDEA 的 Local Changes 标签页仍是空的，文件也没变色（比如未跟踪文件应为红色），说明 IDEA 没识别出当前目录是 Git 仓库。
原因通常是项目根目录和 .git 文件夹不在同一级。IDEA 只在打开的 project root 下自动扫描 .git，如果 .git 在子目录（比如你 cd 进 src/ 再 git init），IDEA 就看不到。
- 确认
.git文件夹位置：终端进项目根目录，运行ls -a | grep .git（macOS/Linux）或dir /ah .git（Windows） - 若
.git不在 project root，删掉它，回到正确根目录重新git init - 如果项目已用其他 IDE 初始化过，检查是否用了
--separate-git-dir，这种非标结构 IDEA 不支持
Commit 提交失败：提示 “No files to commit” 或 “Nothing added to commit”
明明改了文件，也勾选了要提交的变更，点 Commit 却报错说没东西可提交。这通常不是 Git 问题，而是 IDEA 的索引或暂存区状态没同步。
根本原因是：IDEA 的 Local Changes 视图分两栏——“Default Changelist”（未暂存）和 “Staged Changes”（已暂存），而默认提交行为只走“Staged Changes”。如果你没手动 git add，也没在 IDEA 里勾选“Commit and push”，它就真不会提交任何东西。
- 提交前务必确认文件出现在 “Staged Changes” 区域；没出现就右键文件 → Add to VCS（等价于
git add） - 想跳过暂存直接提交？勾选 Commit 窗口左下角的 Commit all changed files（不推荐长期用，容易漏掉不该提交的内容）
- 如果文件显示为灰色或 “Ignored”，检查
.gitignore或 IDEA 的 Settings → Editor → File Types → Ignored files and folders
Push 报错 “Authentication failed” 或 “remote: Support for password authentication was removed”
本地 Commit 成功，但 Push 到 GitHub/GitLab 时报认证失败，尤其是看到 “Support for password authentication was removed”，说明你在用账号密码直连 HTTPS 地址——GitHub 自 2021 年 8 月起已禁用该方式。
解决路径只有一条：换用 token 或 SSH。HTTPS 方式必须用 Personal Access Token（PAT）替代密码；SSH 方式则需生成密钥并添加到远端账户。
- HTTPS 推荐做法：GitHub → Settings → Developer settings → Personal access tokens → Generate new token，勾选
repo权限，复制后在 IDEA 的 Push 对话框里粘贴到 Password 字段（User name 填 GitHub 用户名） - SSH 更省事：终端运行
ssh-keygen -t ed25519，按提示保存，默认路径即可；然后cat ~/.ssh/id_ed25519.pub复制公钥，粘贴到 GitHub → Settings → SSH and GPG keys - 确认远程地址是 SSH 格式：
git remote set-url origin git@github.com:user/repo.git；IDEA 里可在 VCS → Git → Remotes 查看和修改
别指望 IDEA 自动帮你把 HTTPS 改成 SSH，它只会忠实使用你配置的 URL。认证失败时第一反应不是重输密码，而是先查远程地址类型和凭证方式。
