先说说这套框架到底是个啥

咱们先把话说清楚。

它叫 pre‑commit。

别kan名字朴实它其实是个「Git 提交前的守门员」。

说实话，hen多团队就是靠它把代码质量关住。

哈哈，你要是还在手动跑 lint，那真的是在浪费时间。

核心概念：hook、repo、stage

hook要执行的检查。

Ke以是 shell 命令，也Ke以是 Python 脚本，甚至是 Node 可执行文件。

repohooks 的来源仓库。

每个 repo 指向一个 Git 仓库，pre‑commit 会自动拉取对应版本的代码，在隔离环境里跑。

stages执行时机。

默认在 commit 阶段触发，也Neng配置到 push、merge‑commit、prepare‑commit‑msg 等阶段。

为什么大家dou爱上它？

写过 CI 流水线的人dou懂，等代码推到远程才发现格式问题，那叫一个尴尬。

改完重新 push，CI 又跑一遍，同事收到通知，review 被打断。

来回几次一天就过去了。真的好累。

pre‑commit 把检查提前到本地，不通过根本创建不了 commit。

问题在本地就解决了别让烂代码跑进仓库。

多语言团队的福音

想象一下你们项目里有 Go、Python、JS、Rust 四种语言。

每种语言dou要装各自的 lint 工具，还得对齐版本号。

那简直是灾难。哈哈，别闹了！

有了 pre‑commit，一套 .pre‑commit-config.yaml 就Neng管住所有语言的检查。

新成员 clone 完后跑一次 pre-commit install

全团队统一规则立马生效，不用再手动装各种工具。

安装和上手超简单

pip install pre-commit

在项目根目录创建 .pre-commit-config.yaml

声明你要用哪些 hooks，指定版本号。

然后执行：

pre-commit install

一次性跑遍全部文件

pre-commit run --all-files

实际案例：社区维护的现成 hook

# Python 项目常用：

{repo: https://github.com/psf/black, rev: 22.10.0, hooks: }

# JavaScript 项目常用：

{repo: https://github.com/prettier/prettier, rev: v2.8.0, hooks: }

a tiny tip：自动geng新 hook 版本

pre-commit autoupdate

"为什么百度不收录" 那段插曲——顺便聊聊 SEO 小技巧

说起 SEO，你可Neng会好奇：“为啥我的技术博客百度不收录？”

A1：内容太新，爬虫还没来得及抓取。

A2：页面缺少结构化数据或 meta 描述，爬虫判断价值低。

A3：站点 robots.txt 把 /static/ 或 /docs/ 给屏蔽了。

A4：服务器响应慢，被判定为体验差。

A5：内容重复率高，被认为是搬运。

所以啊，要想让百度收录，多写点原创、有深度的文字；保证页面加载快；别忘了加上标题标签和描述。你懂的，这些小细节hen重要。

CICD 与 pre‑commit 的协同工作方式

CICD 是把代码推到远程后再跑检查；而 pre‑commit 是本地第一道防线，两者配合才NengZuo到“零缺陷”。

CICD 负责全量扫描、集成测试；pre‑commit 负责增量扫描、格式化。

Ru果两者冲突怎么办？先让 pre‑commit 把大部分错误拦下来再让 CI 检查剩下的边缘情况。这样Ke以大幅降低 CI 的噪音，也Neng提升团队效率。咱就是说这种分层防御简直太香了！

P.S. 常见误区纠正一下——不对不对，应该是这样：

误区一：只装一个 hook 就Neng覆盖所有语言。其实每种语言dou有专属工具，比如 Go 用 golangci‑lint，Rust 用 clippy。

误区二：认为 pre‑commit 会自动提交代码。它只是阻止不合规的 commit，需要手动修复后再提交。

一下——这套框架到底Neng不Neng管理所有 Git 提交检查？

# Neng！只要你把想要的检查写进 .pre‑commit-config.yaml，它就会帮你管住每一次 git commit 。

# 不行？除非你碰到极端场景，比如需要在 IDE 内实时提示，而不是提交前拦截。这时候Ke以配合 LSP 插件一起使用。

这套框架Yi经被无数开源项目和企业内部采用，效果杠杠滴。咱们老友之间，我建议你马上试试，一键装好后就会感受到「写代码geng安心」的魔力啦！哈哈，有空一起喝杯咖啡聊聊你的实践经验吧！

# 示例配置片段
repos:
  - repo: https://github.com/psf/black
    rev: 22.10.0
    hooks:
      - id: black
        language_version: python3
  - repo: https://github.com/pre-commit/mirrors-eslint
    rev: v8.23.1
    hooks:
      - id: eslint
        files: \.$
  - repo: local
    hooks:
      - id: custom-shell-check
        name: 检查自定义脚本
        entry: ./scripts/check.sh
        language: script
        stages: 

© 2026 技术随笔 – 分享即快乐，不作商业用途，仅供学习交流使用。"

---