必须完成Git环境绑定、GitHub账号登录、仓库创建与远程关联三步闭环,否则Push会失败;需配置Git路径与全局用户信息、用Token登录GitHub、通过Share Project on GitHub一键推送。

要在 IntelliJ IDEA 2026 中把本地代码安全、完整地推送到 GitHub 远程仓库,必须先完成 Git 环境绑定、GitHub 账号登录、仓库创建与远程关联三步闭环,缺一不可——漏掉任意一环,Push 操作都会卡在认证失败或“no upstream configured”提示上。
配置 Git 可执行路径与全局用户信息
打开 IDEA → File → Settings(Windows/Linux)或 IntelliJ IDEA → Preferences(macOS)→ Version Control → Git。
在 Path to Git executable 字段右侧点击文件夹图标,定位到本地 git.exe(Windows 默认为 C:\Program Files\Git\bin\git.exe)或 /usr/bin/git(macOS/Linux)。
点击 Test,看到 “Git version 2.40.1” 类似提示才算通过;若失败,说明 Git 未正确安装或未加入系统 PATH,此时不要跳过,必须重装 Git 并勾选 “Add Git to the system PATH” 选项。
终端执行以下两条命令(替换为你的真实信息):
git config --global user.name "your-github-username"
git config --global user.email "your-verified-github-email"
【这两条命令必须执行,且邮箱必须与 GitHub 账号绑定的主邮箱完全一致】,否则后续提交记录会显示为 “unverified” 或无法关联到你的 GitHub 账户。
绑定 GitHub 账号(推荐 Token 登录)
Settings → Version Control → GitHub → 点击右上角 + 号 → 选择 “Log In with Token”。
前往 GitHub 网站:Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token → 勾选 repo 权限(其他权限可不选)→ Generate token → 复制生成的长字符串。
回到 IDEA,在 Token 输入框中粘贴该字符串 → 点击 OK。IDEA 会立即验证并显示账号头像和用户名。
⚠️ 不要用浏览器登录方式——它在 IDEA 2026.1 中存在 OAuth 重定向超时问题,尤其在企业网络或 macOS Safari 默认设置下极易失败。
一键创建远程仓库并推送全部代码
确保项目已打开(可以是空项目、SpringBoot 工程或任意已有代码目录)。
顶部菜单栏 → VCS → Import into Version Control → Share Project on GitHub。
填写表单:
Repository name:保持默认(自动取项目文件夹名)或手动修改;
Description:一句话说明项目用途;
Visibility:勾选 Private(新手建议先设私有,避免误传敏感配置);
.gitignore:下拉选择 Java(自动排除 target/、*.iml、out/ 等);
License:暂不选,留空即可。
点击 Share → IDEA 自动执行:
git init → git add . → git commit -m "Initial commit" → git remote add origin https://github.com/username/repo.git → git push -u origin main
推送成功后,GitHub 页面将立即显示仓库首页,含 README.md(若你勾选了)、文件列表和 commit 时间线。
日常提交与增量推送操作
修改任意文件后,底部状态栏会显示 “1 modified” 提示。
快捷键 Ctrl+K(Windows/Linux)或 Cmd+K(macOS)→ 弹出 Commit 窗口 → 勾选待提交文件 → 输入有意义的 Commit Message(如 “feat: add login validation”)→ 点击 Commit 按钮(仅写入本地仓库)。
再次快捷键 Ctrl+Shift+K(Windows/Linux)或 Cmd+Shift+K(macOS)→ 弹出 Push 窗口 → 确认分支为 main(或你当前所在分支)→ 点击 Push → 完成同步到 GitHub 远程仓库。
这一步不能省略 Commit 直接 Push,IDEA 会报错 “No changes to commit”,因为 Git 的设计逻辑是“先存本地快照,再发远端”,没有本地 commit 就没有东西可推。


















