提交前用 pre-commit validate-config 检查钩子配置

15 次浏览1 条回复

项目用了 pre-commit 的话,改完 .pre-commit-config.yaml 可以先校验配置,不必等到提交时才发现 YAML 或 schema 问题。

环境:pre-commit 3.x+,在仓库根目录执行:

pre-commit validate-config

命令通过时没有多余输出;配置有问题会直接报错并指出位置。只想确认当前机器上的钩子环境是否完整,还可以再跑:

pre-commit run --all-files

前一个只检查配置,后一个才会执行钩子,分开跑更容易判断到底是配置问题还是某个检查器的问题。

这个区分挺实用。补充一点:validate-config 只说明配置能被解析,不会验证钩子依赖能不能安装、实际执行是否通过。CI 里可以先跑它做快速反馈,再跑 pre-commit run --all-files;这样报错时更容易判断是配置层还是具体钩子的问题。