pre-commit配置：如何让自定义钩子仅在所有前置钩子成功时运行

该需求完全可以实现，不需要依赖全局fail_fast配置，仅通过轻量调整钩子执行逻辑，就能同时满足「通用钩子完整执行不中断」和「前序任意钩子失败则跳过最后本地钩子」两个目标。

核心逻辑说明 #

• pre-commit默认配置下，会严格按照配置列表的顺序，依次执行所有钩子，不会因为某一步返回非零就中断后续流程，这正好匹配你希望isort、black、flake8跑完整个流程的预期。
• 全局fail_fast的局限性在于，它会在第一个返回非零的钩子处直接终止全流程，打断后续通用钩子的执行。我们可以通过引入极轻量的状态标记机制，替代全局中断的判断能力，不需要额外引入第三方依赖。

具体配置调整 #

• 移除顶层的fail_fast: true配置，恢复pre-commit默认的线性执行逻辑。
• 为三个通用钩子封装统一的入口逻辑，替换原来的直接命令：
  • 对isort、black这类自动修复钩子：执行完原有修复操作后，检测是否修改了暂存区的文件；如果有修改，就在pre-commit的全局工作目录（即$PRE_COMMIT_HOME路径）下生成一个空的失败标记文件，脚本最终统一返回0，不触发任何中断逻辑。
  • 对flake8这类静态检查钩子：执行完代码检查后，如果发现不通过的问题，同样在上述路径下生成失败标记文件，脚本最终也统一返回0。

  这步调整的核心是，所有通用钩子不管是修改了文件、还是检查不通过，都不会返回非零退出码，因此pre-commit不会出现中途中断的情况，isort、black、flake8一定会按顺序完整跑完。

• 修改最后本地钩子local_project_specific_magic的入口逻辑：
  • 在执行真正的magic_script.sh之前，先检查刚才的失败标记文件是否存在。
  • 如果标记文件存在：说明前面任意一个通用钩子触发了失败条件（修改了暂存文件、静态检查不通过），直接退出，不执行项目专属逻辑。
  • 如果标记文件不存在：说明前面所有通用钩子都顺利通过校验，正常执行magic_script.sh的完整逻辑。

最终执行效果 #

调整完成后的流程完全匹配预期：

• isort执行完成哪怕修改了导入顺序，也不会中断流程，会继续触发black的格式化操作。
• black执行完成哪怕调整了代码格式，也不会中断流程，会继续触发flake8的静态检查。
• 只要前面三个任意一步触发了失败条件，最后的本地钩子就会被跳过。
• 只有前面三个步骤全部顺利通过、没有任何修改或报错，本地钩子才会正常执行。

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