intellij idea 2021.3 及以后版本自带 git 插件且默认启用，无需手动安装；只需配置系统已安装的 git 可执行文件路径（如 windows 为 c:\program files\git\bin\git.exe），点击 test 验证显示版本号即成功。
IDEA 里根本不用手动装 Git 插件
IntelliJ IDEA（2021.3 及以后所有主流版本）自带完整的 Git 集成支持，Git 插件默认启用且不可卸载。你唯一要做的，是让 IDEA 找到系统已安装的 git.exe —— 它不提供 Git 二进制文件，只调用本地 Git 命令行。
常见错误现象：
- Settings → Version Control → Git 页面显示 “Git executable not found”
- 点击
Test报错 “Cannot run program 'git': CreateProcess error=2”
原因不是插件没装，而是：Git 没装，或装了但没加进 PATH，或 IDEA 没扫到正确路径。
实操建议：
- 确认已安装 Git（推荐 2.40+ 版本），安装时务必勾选 Add Git to PATH（Windows）或使用 Homebrew（macOS）
- 打开终端执行
which git（macOS/Linux）或where git（Windows CMD），拿到真实路径（如C:\Program Files\Git\bin\git.exe） - 在 IDEA 的
Path to Git executable中粘贴该路径，**不要用cmd\git.exe或usr\bin\git这类错误路径** - 点击
Test，看到类似git version 2.41.0.windows.1即成功
GitHub 登录必须用 Personal Access Token，密码已失效
自 2021 年 8 月起，GitHub 全面停用账号密码登录 API 方式。IDEA 中通过 Log In via GitHub 弹窗输密码，必然失败并提示 Authentication failed 或 Bad credentials。
实操建议：
- 访问
https://github.com/settings/tokens→Generate new token→Generate new token (classic) - Token 名称随意（如
idea-2026），权限至少勾选：repo、workflow、read:org（若用组织仓库） - 生成后立即复制——页面关闭后无法再次查看明文
- 回到 IDEA：Settings → Version Control → GitHub →
Add Account→Log In with Token→ 粘贴 Token - 测试连接成功后，IDEA 左下角状态栏会显示 GitHub 图标和你的用户名
配置远程仓库前先确认 .gitignore 和初始提交状态
很多人点完 Commit Directory 就直接 Push，结果远程仓库里混入 .idea/、target/、out/ 等 IDE 或构建产物，既污染历史又可能泄露配置。
实操建议：
- 在项目根目录手动创建
.gitignore文件（不是.gitignore.txt），内容至少包含：
.idea/ *.iml out/ target/ *.log .DS_Store
- 右键项目 →
Git → Add，此时文件变绿色，表示已暂存；但.gitignore本身必须也在暂存区，否则不生效 - Commit 时务必勾选
Include files from ignored patterns取消（默认勾选，要手动关掉），避免误提交忽略项 - 首次 Commit 的 Message 别留空，写
init: project setup这类明确信息 - Push 前检查右下角 Git 状态栏是否显示
main（或master）分支名，且无未推送提交标记
“Push” 失败常见于 remote URL 权限或协议不匹配
即使 GitHub 账号登录成功，Push 仍可能报错：remote: Permission to user/repo.git denied、fatal: unable to access 'https://github.com/...': SSL certificate problem，或卡在认证弹窗。
本质是远程地址用了 HTTPS 协议但 Token 权限不足，或用了 SSH 协议但本地没配好密钥。
实操建议：
- 优先用 HTTPS + Token：在 Settings → Version Control → Git →
Manage Remotes中，URL 格式应为https://<token>@github.com/username/repo.git</token>（不推荐，Token 明文暴露）或更安全地留空 token，靠已登录账号自动注入 - 更推荐 SSH：生成
ssh-keygen -t ed25519 -C "your_email@example.com"，将公钥id_ed25519.pub内容粘贴到 GitHub → Settings → SSH and GPG keys - 确保 remote URL 是
git@github.com:username/repo.git（不是 https 开头） - 若遇 SSL 证书错误，**不要执行
git config --global http.sslVerify false** —— 这是危险降级，应改用可信 CA 或换网络环境
最容易被忽略的一点：IDEA 的 Git 配置是全局生效的，但每个项目可单独设置 remote 和 branch tracking。别假设“设过一次就永远 OK”，尤其当你在公司内网、GitHub Enterprise、Gitee 之间切换时，remote URL 和认证方式很可能需要逐项目调整。
