git pull执行报错"Not possible to fast-forward" 线性提交历史场景排查

问题根因 #

• 两个配置叠加触发报错：
  1. 你的全局Git配置开启了 pull.ff = only 规则，要求所有git pull操作必须仅执行快进合并，禁止自动生成合并提交或自动rebase
  2. VSCode的「同步」功能默认执行逻辑是先执行拉取（pull）再执行推送（push）。你当前本地issue-215分支比远端origin/issue-215超前1个提交，此时pull相当于要把远端的旧版本合并到本地的新版本上，完全不符合快进合并的条件，因此直接抛出错误。

补充：Git 2.27及以上版本会对未配置pull默认行为的用户弹出配置提示，很多用户会误选ff-only选项，这也是该问题突然出现的常见原因。

验证方法 #

执行以下命令查看全局pull配置：

git config --global --get pull.ff

如果输出结果为only，即可确认是该配置导致的问题。

解决方案 #

提供两种可选方案，按需选择即可：

方案1：修改全局pull策略，保留VSCode同步按钮使用习惯 #

你可以选择以下任意一种默认策略，替换掉当前的ff-only配置：

• 恢复Git默认行为：快进可用时执行快进，否则生成合并提交

git config --global pull.ff true

• 偏好线性提交的场景：pull时自动执行rebase操作，不会生成合并提交

git config --global pull.rebase true

两种配置都可以完全解决当前报错。

方案2：不修改现有配置，直接手动推送 #

如果你确定远端分支没有新的提交需要拉取，不需要执行pull操作，直接执行推送命令即可：

git push origin issue-215

也可以在VSCode界面直接点击「推送」按钮，不要点击「同步」按钮，就不会触发多余的pull操作，自然不会触发报错。

内容的提问来源于stack exchange，提问作者Coderer