登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  软件教程

Git提交被拒怎么解决?Push失败原因及修复方法

时间:2026-05-01 20:09:54 121浏览 收藏

当Git push被拒时,别慌——这通常是远程分支更新、权限不足、分支保护规则触发或本地配置异常所致;本文系统梳理了五大核心解决路径:先拉取合并或rebase同步最新变更以应对非快进拒绝,再检查远程URL、认证凭证与SSH连接确保权限无误,接着针对分支保护规则灵活选择PR流程或安全强制推送(推荐--force-with-lease),最后修复本地分支跟踪关系让推送更智能;每一步都附带实操命令与关键提示,助你快速定位问题、安全恢复协作节奏。

Git提交代码被拒绝怎么处理_GitPush被拒原因及解决方法

如果您尝试将代码推送到远程仓库时收到“Git push被拒”的提示,则可能是由于远程分支存在新提交而本地分支未同步、权限不足、分支保护规则触发或强制推送被禁止等原因导致。以下是解决此问题的步骤:

一、拉取远程最新变更并合并

该方法适用于远程分支已有他人提交,而您的本地分支尚未更新,导致推送因非快进(non-fast-forward)被拒绝。Git 默认拒绝覆盖远程历史,需先整合远程更改。

1、在项目根目录打开终端或命令行工具。

2、执行 git pull origin 当前分支名,例如 git pull origin main

3、若出现合并冲突,手动编辑冲突文件,保存后执行 git add .git commit -m "resolve merge conflicts"

4、再次运行 git push origin 当前分支名

二、使用 rebase 同步而非 merge

该方法可保持提交历史线性整洁,避免产生多余的合并提交,适用于希望维持简洁提交图谱的场景。

1、执行 git fetch origin 获取远程最新引用信息。

2、运行 git rebase origin/当前分支名,例如 git rebase origin/main

3、如遇冲突,解决后执行 git add .,再运行 git rebase --continue

4、完成 rebase 后执行 git push origin 当前分支名

三、检查并修正远程仓库 URL 与权限

该方法用于排除因远程地址错误、认证失效或账户无写入权限导致的推送失败,常见于私有仓库或企业 Git 服务。

1、运行 git remote get-url origin 确认远程地址是否正确。

2、若使用 HTTPS 协议,检查凭据管理器中存储的用户名和密码(或个人访问令牌)是否有效;若使用 SSH,确认 ~/.ssh/id_rsa.pub 已添加至 Git 托管平台的 SSH Keys 设置中。

3、执行 ssh -T git@hostname(如 ssh -T git@github.com)测试 SSH 连通性与身份识别。

4、若权限不足,联系仓库管理员确认您在目标分支上拥有 push 权限。

四、绕过分支保护规则(仅限授权用户)

该方法适用于远程仓库启用了分支保护(如 GitHub 的 Branch Protection Rules、GitLab 的 Protected Branches),要求 PR 审查、状态检查通过或禁止强制推送等限制。

1、访问远程仓库网页界面,进入 Settings > Branches 页面,查看当前分支的保护规则详情。

2、若规则要求 Pull Request,需先创建 PR 并通过所有审批与 CI 检查,再由维护者合并。

3、若具备管理员权限且确需跳过检查,可临时禁用对应规则,或使用 git push --force-with-lease(推荐)替代 --force,以防止意外覆盖他人提交。

4、执行强制推送前,务必确认本地分支历史已准确反映预期状态,并通知协作者。

五、修正本地分支跟踪关系

该方法适用于本地分支未正确设置上游(upstream)分支,导致 git push 无法自动识别推送目标,从而报错或推送到错误位置。

1、运行 git branch -vv 查看当前分支是否关联远程分支及关联状态。

2、若显示 [origin/xxx: gone] 或无远程追踪信息,执行 git branch --set-upstream-to=origin/当前分支名 当前分支名

3、验证设置是否生效:运行 git config --get branch.当前分支名.remotegit config --get branch.当前分支名.merge,应分别返回 originrefs/heads/当前分支名

4、此后可直接使用 git push 而无需指定远程与分支名。

今天关于《Git提交被拒怎么解决?Push失败原因及修复方法》的内容介绍就到此结束,如果有什么疑问或者建议,可以在golang学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>