You need to enable JavaScript to run this app. Git推送gh-pages分支提示rejected non-fast-forward错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Git推送gh-pages分支提示rejected non-fast-forward错误如何解决?

错误原因

该错误为Git的non-fast-forward(非快进式推送)拒绝机制触发,核心原因是远程gh-pages分支存在本地分支没有的新提交,本地分支的提交历史滞后于远程分支。常见的触发场景包括:

  • 其他协作者向远程gh-pages分支推送过新内容
  • 你在其他设备上修改过gh-pages分支并推送到远程
  • 你开启了GitHub Pages的自动构建功能,远程自动生成了新的提交记录

Git默认禁止直接推送滞后的分支,避免覆盖远程已有的提交内容,因此抛出该报错。

解决方法

根据是否需要保留远程gh-pages的现有内容,选择对应处理方案:

方案1:保留远程提交(推荐,无数据丢失风险)

  • 先切换到本地gh-pages分支:
    git checkout gh-pages
  • 拉取远程gh-pages的最新提交合并到本地:
    git pull origin gh-pages
    • 如果出现合并冲突,手动打开冲突文件修改为需要的内容后,依次执行git add <冲突文件路径>、git commit -m "合并远程gh-pages变更"完成合并
  • 合并完成后重新推送即可:
    git push origin gh-pages

方案2:直接覆盖远程分支(仅适合确定不需要远程现有内容的场景)

如果你的gh-pages分支是框架自动生成的静态站点分支,每次部署都会重新生成全量内容,不需要保留之前的远程提交,可以直接执行强制推送:
git push -f origin gh-pages
注意:该操作会清空远程gh-pages分支的所有历史提交,替换为本地分支内容,谨慎使用

内容的提问来源于stack exchange,提问作者Ali Raza

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 11:36:04