手机版

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

时间:2026-09-08 349
Git push被拒需按五步排查:一、拉取远程变更并合并;二、用rebase同步保持历史线性;三、检查远程URL、认证与权限;四、授权用户可绕过分支保护规则;五、修正本地分支跟踪关系。

如果您尝试将代码推送到远程仓库时收到“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 而无需指定远程与分支名。

女子学校安检员安卓最新版
6.0
模拟经营 20 MB
扫一扫手机安装更便捷