首页/开发/CI/CD 与发布速查/pre-commit 提交前钩子
工具链要点63 条

pre-commit 提交前钩子

统一管理 Git 钩子:格式化、lint、密钥扫描等在提交前自动执行;同一配置在 CI 复跑,防止本地绕过。

CI/CD 与发布速查开发更新于 2026-10-12
配置.pre-commit-config.yaml
安装pre-commit install 写入钩子
全量运行pre-commit run --all-files
闭环CI 同样执行,防 --no-verify 绕过

配置示例

配置示例
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.6.0
    hooks:
      - id: end-of-file-fixer
      - id: check-yaml
  - repo: https://github.com/gitleaks/gitleaks
    rev: v8.18.4
    hooks:
      - id: gitleaks
本地钩子提升提交质量,CI 复跑保证一致性:两道都有才闭环。

易错点

  • 只依赖本地钩子:--no-verify 或新机器未安装即可绕过
  • 钩子里跑全量测试:提交变慢后被禁用,选快速稳定的检查项

数据来源与参考

  • pre-commit 官方文档《Usage》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌