如何同步CI与pre-commit检查？保障校验版本一致性

问题背景 #

我用Poetry管理项目，用poethepoet配置了pre-commit钩子，目前运行正常；同时搭了TravisCI流水线，现在只跑单元测试。未来要转协作开发，担心同事用git commit或git push加--no-verify跳过本地检查，想确保代码仍能通过校验，有几个疑问：

1. 将pre-commit钩子的校验工作与CI流水线同步是不是最佳实践？
2. 如果重复执行pre-commit校验不是最佳实践，在已用pre-commit的前提下，CI里运行代码检查工具的常规方式是什么？
3. 怎么确保pre-commit和CI里的代码检查工具版本一致，且易维护——比如更新Ruff钩子版本时，CI里的Ruff版本也同步更新？

解答 #

1. 同步pre-commit校验到CI是标准最佳实践 #

完全是最佳实践，甚至是必须的。本地pre-commit钩子虽然能在提交前拦截不合规代码，但--no-verify可以轻松跳过，协作场景下总会有人因为各种原因用这个参数。把pre-commit的校验逻辑搬到CI里强制执行，能从源头阻止不符合规范的代码合并到主分支，保证仓库代码的一致性。

2. CI中运行检查的常规方式：直接用pre-commit全量检查 #

不存在“重复执行是反最佳实践”的说法——CI的核心作用就是兜底，和本地钩子的职责互补。在已使用pre-commit的场景下，最常规也最省心的方式就是直接在CI中运行pre-commit run --all-files，而不是单独去配置各个linter的命令。这样做的好处是完全复用pre-commit的配置，不用在CI脚本里重复写各个工具的调用逻辑。

3. 确保版本一致且易维护的方案 #

要实现pre-commit和CI工具版本同步，核心是用.pre-commit-config.yaml作为唯一的版本配置源：

• 所有钩子（比如Ruff）的版本都在.pre-commit-config.yaml里指定，示例：

  repos:
    - repo: https://github.com/astral-sh/ruff-pre-commit
      rev: v0.1.15
      hooks:
        - id: ruff
  

• 在CI流水线中，只需要安装pre-commit，然后执行pre-commit run --all-files即可。pre-commit会自动根据配置文件拉取对应版本的钩子工具，不需要在CI脚本里单独安装Ruff等工具。
• 结合Poetry的话，可以把pre-commit加入开发依赖（poetry add --dev pre-commit），CI里通过poetry run pre-commit run --all-files执行，进一步统一环境。

这样一来，你只需要更新.pre-commit-config.yaml里的rev字段，CI就会自动使用新版本的工具，完全不需要修改CI脚本，维护成本极低。

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