git 本地推送失败落后于远程 main

有的时候博客内容会有变动，首发博客是最新的，其他博客地址可能会未同步, 认准 https://blog.zysicyj.top

1
2
3
4
5
6
7
8
9
17:29:32.082: [nariapp_v2] git -c credential.helper= -c core.quotepath=false -c log.showSignature=false push --progress --porcelain origin refs/heads/main:refs/heads/main --set-upstream
error: failed to push some refs to 'http://localhost:8929/cadre/app-v2.git'
To http://localhost:8929/cadre/app-v2.git
!	refs/heads/main:refs/heads/main	[rejected] (non-fast-forward)
hint: Updates were rejected because the tip of your current branch is behind
Done
hint: its remote counterpart. If you want to integrate the remote changes,
hint: use 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

这个错误信息表明你尝试将本地分支 main 推送到远程仓库时被拒绝了。具体原因是你的本地分支 main 落后于远程分支 main，这意味着远程仓库中的 main 分支包含了你本地分支没有的提交记录。

产生原因

  1. 非快进更新（non-fast-forward）：Git 不允许非快进更新，这意味着你不能直接覆盖远程分支中已有的提交记录。为了保护已有的提交记录，Git 会拒绝这种推送。
  2. 本地分支落后于远程分支 ：你的本地分支 main 没有包含远程分支 main 上的最新提交记录。

解决方法

  1. 合并远程分支的更改 ：

    1. 首先，拉取远程分支的最新更改：

      1
      git pull origin main

    2. 然后再次尝试推送：

      1
      git push origin main

  2. 强制推送（不推荐，除非你确定这样做不会影响其他人）：
    如果你确定你不需要保留远程分支上的更改，可以使用 --force 强制推送：

    1
    git push origin main --force

    注意 ：强制推送会覆盖远程分支上的提交记录，这可能会导致其他开发者的提交丢失，因此要慎重使用。

原理

  • Git 的快进更新 ：Git 默认要求推送必须是快进的，这意味着本地分支必须包含远程分支的所有提交记录。这样可以确保提交记录的线性历史不会被破坏。
  • 合并远程更改 ：通过拉取远程分支的更改，你可以将远程分支上的提交记录合并到本地分支中，从而使本地分支包含所有远程分支的提交记录。
  • 强制推送 ：强制推送会忽略非快进更新的限制，直接覆盖远程分支的提交记录。这种操作会破坏提交记录的线性历史，因此需要谨慎使用。

通过上述方法，你可以解决推送被拒绝的问题，并确保代码库的提交历史保持一致。