git push提示“non-fast-forward”或“rejected”的根本原因是远程分支有新提交而本地未同步，Git为防覆盖他人工作默认拒绝非快进更新。
为什么
会提示 “non-fast-forward” 或 “rejected”
根本原因是远程分支的最新提交不在你的本地分支历史中——换句话说，别人已经往远程推了新提交，而你本地还停留在旧版本上。Git 默认拒绝覆盖这种“非快进”更新，防止误删他人工作。
常见触发场景：
没做就直接
；多人协作时队友先推送了；自己在其他机器改完又没同步就切回原环境推送。
错误典型提示：
或
注意第二种带
的，是远程仓库被设为裸仓以外的普通工作目录（极不推荐），需单独处理
这不是网络或权限问题，和 SSH/HTTPS 认证成功与否无关
正确做法：先拉取再合并，而不是强制推送
绝大多数情况应该用
同步变更，让 Git 自动尝试 fast-forward 或创建 merge commit。
如果本地有未提交修改，
可能失败，此时优先考虑：
运行
确认当前状态，尤其留意是否有 untracked / modified 文件
若只是暂存了改动但没提交，可先
→
→
若已提交但不想产生 merge commit，可用
，它把你的本地提交“重放”到远程新基线上，保持线性历史
避免无脑
，它会抹掉远程他人提交，协作中等同于删库跑路
什么情况下能用
仅当你确认远程分支只有你自己在写、且你只是想覆盖自己上次推送的“临时提交”（比如修正 commit message、撤回一个错推的调试提交）时，才考虑这个命令。
它比
安全，因为会检查远程引用是否和你本地记录的一致——如果别人在你 fetch 之后又推了，它就会中止，避免静默覆盖。
Git
程序猿必备版本控制工具
下载
使用前必须先
（或
），确保你知道远程当前 HEAD 是什么
不要对
/
这类保护分支使用，CI/CD 流水线可能已基于旧提交运行
某些平台（如 GitHub）默认禁止 force-push 到 protected branches，即使加
也会被拒绝
远程是普通工作目录导致的 “refusing to update checked out branch” 怎么办
这是 Git 的安全限制：不允许向一个已检出分支（即远程仓库里
显示有工作区）推送。根本解法是让远程变成裸仓库（bare repo）。
如果你控制远程服务器，立刻执行：
然后删掉所有工作区文件（
，除
外），再
把内容提一层——或者更稳妥：重新
一份。
如果远程是共享文件夹（比如 SMB/NFS），且无法改配置，唯一临时办法是登录远程机器，手动
切走目标分支（例如切到
），再推送，但这治标不治本
任何文档里教你在远程运行
的方案，都属于埋雷，会导致远程工作区和 Git 数据库不一致，后续
显示混乱
真正麻烦的从来不是命令记不住，而是分不清“我该同步别人”和“我要覆盖别人”的边界。每次看到
，先停三秒看一眼
，比翻十篇教程都管用。
git pushgit pullgit push! [rejected] main -> main (non-fast-forward)! [remote rejected] dev -> dev (refusing to update checked out branch)refusing to update checked out branchgit pullgit pullgit statusgit stashgit pullgit stash popgit pull --rebasegit push --forcegit push --force-with-lease--forcegit fetchgit pull --rebasemainmaster--force-with-leasegit statuscd /path/to/remote/repo
git config --bool core.bare truerm -rf *.gitmv .git/* . && rm -rf .gitgit clone --baregit checkoutdevgit config receive.denyCurrentBranch ignoregit statusrejectedgit log --oneline --graph --all