“non-fast-forward”是Git拒绝推送的保护机制,因远程分支有本地缺失的提交;应先git pull --rebase同步更新,避免覆盖他人工作。

git push 被拒绝:non-fast-forward 是什么
这是远程分支有你本地没有的提交时最常见的报错,比如别人先 push 了新 commit,而你还在旧的 HEAD 上做修改并尝试推送。Git 拒绝覆盖,因为这会丢弃他人工作。
- 这不是网络或权限问题,而是 Git 的保护机制
-
git pull通常能解决,但要注意它默认执行git pull --ff-only(仅快进),如果本地有未 push 的 commit,可能仍失败 - 更稳妥的做法是
git pull --rebase:把你的改动“重放”到最新远程提交之后,避免生成无意义的 merge commit
执行前确认当前分支干净(git status 无未提交变更),否则 rebase 可能中断并留下冲突需要手动处理。
git commit 后发现写错了 message 怎么改
刚 commit 完、还没 push,用 git commit --amend 最直接。它会打开编辑器让你重写 message,同时把暂存区最新改动也合并进去(如果之前 git add 过新文件)。
- 如果只是改 message,确保没再
git add新内容,否则会误把不该提交的文件塞进去 - 已 push 过的 commit 不能直接 amend,强行
git push --force-with-lease会覆盖远程历史,协作中极危险 -
git commit --amend -m "new message"可跳过编辑器,适合脚本化或快速修正
注意:--amend 本质是创建一个新 commit 替换旧的,旧 commit 会被 Git 标记为“悬空”,约 30 天后被 gc 清理。
git-cliff 使用约定式提交和正则表达式驱动的自定义解析器从 Git 历史记录中生成变更日志文件。该工具使用 Rust 编写,通过 TOML 配置文件提供高度可定制的模板,并集成了 GitHub Actions、Docker 和 CI/CD 流水线。
提交时提示 Your branch is ahead of 'origin/main' by X commits
这说明你本地有 commit 没推上去,但 push 却失败了——常见于远程分支被 force-push 过、或你本地分支曾被 reset/rebase 过,导致和远程失去直系祖先关系。
- 先运行
git status看具体 ahead 数量和分支名(可能是main、master或其他) - 不要直接
git reset --hard origin/main,除非你确定要丢弃本地所有未 push 的改动 - 更安全的是
git log origin/main..HEAD查看“多出来的那些 commit”到底是什么,再决定是 rebase、cherry-pick 还是人工合并
这个提示本身不阻止提交,只提醒你本地和远程不同步;真正卡住的是后续的 git push。
.gitignore 写了但文件还在 staging 区
.gitignore 只对尚未被 Git 跟踪的文件生效。如果文件曾经 git add 过,就算后来加进 .gitignore,Git 依然会继续追踪它。
- 先确认状态:
git check-ignore -v <filename></filename>,它会告诉你为什么该文件没被忽略(比如已被跟踪) - 解决办法是让 Git 停止跟踪但保留工作区文件:
git rm --cached <filename></filename> - 如果是一批文件,比如整个
node_modules/:git rm -r --cached node_modules/ - 提交这次删除操作后,后续该路径下的新文件才会受
.gitignore控制
别漏掉 --cached 参数,否则文件会被物理删掉,不只是从 Git 移除。

















