在Git版本控制系统的日常使用中，git pull 命令是开发者同步远程仓库最频繁的操作之一。而 --ff-only 选项作为防止意外合并提交的“安全锁”，早已成为许多团队工作流中的标配。但你是否好奇过：这个实用的选项究竟是从Git的哪个版本开始引入的？ 本文带你拨开历史迷雾，回顾这一功能的前世今生。

什么是 --ff-only？为何需要它？

在解释版本溯源之前，先简单回顾 --ff-only 的作用。当执行 git pull 时，Git默认会先执行 git fetch 获取远程更新，然后尝试合并（merge）。如果本地分支从上次拉取后没有新提交，但远程有进展，Git会采用“快进合并”（fast-forward），直接将本地指针前移。然而，如果本地有未推送的提交，而远程也有新提交，Git就会创建一个新的合并提交（merge commit），导致历史出现分叉。

--ff-only 选项强制要求合并必须为快进模式，否则直接报错并终止操作。这能有效避免意外的合并提交，尤其适合那些希望保持线性历史的团队（例如使用 git rebase 工作流）。可以说，它是“安全网”，也是“纪律员”。

版本溯源：Git 1.6.6 的里程碑

根据Git官方发布日志及代码仓库的commit记录，git pull 的 --ff-only 选项首次出现在 Git v1.6.6 中，该版本于 2009年12月22日 正式发布。这一功能由Git核心贡献者Junio C Hamano等人实现，对应的commit编号为 1fc561d（针对 git-merge 的 --ff-only 支持）以及后续对 git-pull 的适配。

实际上，--ff-only 最初是为 git merge 命令设计的。在Git 1.6.6中，git merge --ff-only 已经可用，而 git pull 作为 git fetch + git merge 的组合，自然也继承了这一选项。因此，从1.6.6开始，开发者就可以在 git pull 后加上 --ff-only 来限制合并行为。

早期使用：为何未引起轰动？

有趣的是，在Git 1.6.6发布后的很长一段时间里，--ff-only 的使用并不广泛。原因有三：其一，当时Git的社区规模远不如今天，许多团队还处于从SVN切换到Git的摸索期；其二，默认的 git pull 行为（允许合并提交）更符合初学者的直觉；其三，--ff-only 并非默认选项，知道它的开发者较少。

直到2010年代中期，随着GitHub、GitLab等平台的兴起，以及持续集成/持续部署（CI/CD）流水线对线性历史的严格要求，--ff-only 才逐渐成为“最佳实践”。许多现代开发工作流甚至通过配置 git config pull.ff only 将其设为全局默认行为。

版本演进：后续改进与配置化

Git 1.6.6之后，--ff-only 在后续版本中得到了持续完善：

  • Git 1.7.0（2010年2月）：改进了错误提示信息，当快进失败时输出更明确的建议（如“不是fast-forward，请考虑使用 --rebase”）。
  • Git 1.8.4（2013年8月）：引入 pull.ff 配置项，允许用户通过 git config pull.ff only 全局设置，无需每次手动输入选项。
  • Git 2.0（2014年5月）：优化了 --ff-only 与 --rebase 的冲突处理，确保两者不会同时生效。
  • Git 2.34（2021年11月）：增加了对 pull.ff 配置的警告机制，防止用户误设置为 false 造成意外。

值得一提的是，从Git 2.0开始，git pull 默认行为依然未变（允许合并），但 --ff-only 的稳定性和兼容性已非常成熟。

对开发者的启示

了解 --ff-only 的版本起源，不仅是为了满足技术考古的好奇心，更在于理解Git设计哲学：始终为开发者提供精确控制能力，同时保持向后兼容。从1.6.6到如今近十五年，这一选项从未被废弃或修改格式，体现了Git核心团队对用户契约的尊重。

对于仍在使用较老版本Git（如某些企业环境中的Git 1.7.x或1.8.x）的开发者，请确认你的版本是否支持 --ff-only——好消息是，只要版本 ≥ 1.6.6，你就可以放心使用。对于新项目，建议从第一天起就配置 git config --global pull.ff only，避免团队协作中的“合并污染”。

结语

从Git 1.6.6到2.40+，--ff-only 走过了十余年，从默默无闻到成为Git工作流的基石之一。下次当你执行 git pull --ff-only 时，不妨回想一下2009年那个冬天，正是这个小小的选项，开启了现代Git协作的新篇章。技术的演进往往就藏在这样细微的改进之中，而理解它们，正是我们成为更好开发者的关键一步。