自动化与效率工具
开场:哪些事值得自动化
日常开发里有几类事反复出现,每次手动做既慢又容易忘:
提交前检查代码格式、跑静态检查;
提交信息格式是否规范;
推送前跑一遍单元测试;
推送后自动跑 CI、自动部署;
找“这个 bug 是哪次提交引入的”。
前四类用 hooks + CI 解决,第五类用 git bisect 解决。 另外顺手配几个 alias 缩短高频命令,用 git blame 追溯某行代码的来历。
Git Hooks 是什么
要解决什么:有些检查每次提交/推送前都该做,但靠人记不住,想让 Git 在特定动作前后自动执行。
Hook 就是“钩子”:Git 在特定动作前后,自动执行你指定的脚本。分两类:
类型 | 在哪执行 | 常见钩子 |
|---|---|---|
客户端钩子 | 本地仓库 |
|
服务端钩子 | 远程仓库 |
|
钩子脚本放在 .git/hooks/ 下。git init 时会生成一堆 .sample 文件,去掉 .sample 后缀就生效:
ls .git/hooks/
pre-commit.sample
commit-msg.sample
pre-push.sample
....git/hooks/ 不在版本控制里,不会随 clone 同步
团队共享钩子不能直接提交这个目录。解决方案在后面“团队共享钩子”一节。
三个最常用的客户端钩子
pre-commit:提交前检查
要解决什么:提交里混进了调试代码、格式不合规,想在提交真正创建前拦下来。
在 git commit 真正创建提交之前执行。返回非零退出码,提交就被拒绝。
一个最简单的例子,检查有没有调试打印:
#!/bin/sh
if git diff --cached | grep -q "console.log"; then echo "发现 console.log,请先删除" exit 1
fi保存到 .git/hooks/pre-commit,加执行权限:
chmod +x .git/hooks/pre-commit之后 git commit 时,如果暂存区里有 console.log,提交会被拦下。
pre-commit 检查的是暂存区,不是工作区
钩子里用的是 git diff --cached,看的是“将要提交的内容”。 如果你改了文件但没 git add,钩子看不到这些改动。 这是关键区别:钩子检查的是“这次提交会带上什么”,不是“你眼前改了什么”。
commit-msg:检查提交信息格式
要解决什么:团队约定提交信息必须写成 类型: 说明 这个格式,但总有人写错。
在提交信息写完之后、提交创建之前执行。参数是提交信息文件路径。
#!/bin/sh
MSG_FILE=$1
PATTERN="^(feat|fix|docs|style|refactor|test|chore): .+"
if ! grep -qE "$PATTERN" "$MSG_FILE"; then echo "提交信息不符合格式:类型: 说明" echo "类型可选:feat/fix/docs/style/refactor/test/chore" exit 1
fi保存到 .git/hooks/commit-msg,加执行权限。之后提交信息写错格式,会被拒绝。
pre-push:推送前检查
要解决什么:推送前想跑一遍测试,避免把坏代码推上去。
在 git push 真正发送数据之前执行。适合跑单元测试、检查分支名。
#!/bin/sh
npm test
if [ $? -ne 0 ]; then echo "测试失败,推送被拒绝" exit 1
fi这个钩子要谨慎用:测试慢的话,每次推送都等很久。可以只跑快速检查,完整测试交给 CI。
其他常见钩子
钩子 | 时机 | 典型用途 |
|---|---|---|
| 提交创建后 | 通知、记录日志 |
| rebase 前 | 检查分支是否允许 rebase |
| 切分支 / 检出后 | 安装依赖、生成配置 |
| 合并后 | 安装依赖、迁移数据库 |
跳过钩子
git commit --no-verify
git push --no-verify但不要养成习惯。钩子被跳过,等于检查没做。紧急情况用一次,事后补上。
钩子不能当安全边界
客户端钩子可以被 --no-verify 绕过,也可以被直接删掉。所以:
钩子用于提高效率、提前发现问题;
真正的强制检查放在 CI / 服务端钩子上;
密钥扫描这类安全要求,不能只靠
pre-commit。
团队共享钩子
要解决什么:.git/hooks/ 不进版本控制,怎么让团队都用同一套钩子?
方案一:把钩子放进仓库,用配置指向它
在仓库里建 githooks/ 目录,放钩子脚本,提交进版本控制。然后配置:
git config core.hooksPath githooksGit 会去 githooks/ 找钩子,而不是 .git/hooks/。 团队每个人 clone 后执行一次这个配置即可。可以写进 README 或初始化脚本。
方案二:用 Husky(前端项目常用)
Husky 是 Node 生态的钩子管理工具:
npx husky init它会创建 .husky/ 目录,并在 package.json 里配置。 钩子脚本提交进仓库,npm install 时自动安装。
# .husky/pre-commit
npm run lint适合前端 / Node 项目。其他语言有对应工具:Python 有 pre-commit 框架,Go 有 lefthook 等。
方案三:pre-commit 框架(语言无关)
pre-commit 是一个 Python 写的钩子管理工具,支持多种语言:
pip install pre-commit在仓库根目录建 .pre-commit-config.yaml:
repos: - repo: https://github.com/pre-commit/pre-commit-hooks rev: v4.5.0 hooks: - id: trailing-whitespace - id: end-of-file-fixer - id: check-yaml安装钩子:
pre-commit install之后每次 commit 自动跑配置里的检查。配置进版本控制,团队共享。
GitHub Actions 入门
要解决什么:hooks 是本地检查,可以被绕过;想要一个跑在远程、团队都绕不过的检查。
GitHub Actions 是 GitHub 的 CI/CD 服务。在仓库根目录建 .github/workflows/ 目录,放 YAML 文件:
.github/workflows/ci.yml一个最小例子:
name: CI on: push: branches: [main] pull_request: branches: [main] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: 20 - run: npm ci - run: npm test逐段解释:
字段 | 含义 |
|---|---|
| workflow 名字,显示在 GitHub 页面上 |
| 触发条件。这里是推送到 main、或向 main 提 PR 时触发 |
| 一个 workflow 可以包含多个 job,并行或串行执行 |
| 运行环境 |
| 步骤列表 |
| 使用现成的 action,比如 |
| 执行 shell 命令 |
常用触发事件
on: push: branches: [main, develop] pull_request: branches: [main] schedule: - cron: '0 2 * * *' # 每天凌晨 2 点 workflow_dispatch: # 手动触发常用 action
action | 作用 |
|---|---|
| 检出代码,几乎每个 workflow 都需要 |
| 安装语言环境 |
| 缓存依赖,加速构建 |
| 上传构建产物 |
查看运行结果
推送后,在 GitHub 仓库页面点 Actions 标签,能看到每次运行的状态、日志、耗时。 PR 页面也会显示检查是否通过。
GitHub Actions 有免费额度
公开仓库免费,私有仓库每月有分钟数限制。大项目要注意构建时间和缓存策略。
alias:给常用命令起短名字
要解决什么:有些命令每天敲几十遍,太长。
设置 alias
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit之后 git st 等价于 git status。
带参数的 alias:
git config --global alias.lg "log --oneline --graph --decorate --all"之后 git lg 就是那条长命令。
几个值得配的 alias
git config --global alias.last "log -1 HEAD --stat"
git config --global alias.unstage "restore --staged"
git config --global alias.amend "commit --amend --no-edit"
git config --global alias.undo "reset --soft HEAD~1"git undo 撤销最近一次提交但保留改动,比每次敲 reset --soft HEAD~1 快。
查看和删除
git config --global --get-regexp alias
git config --global --unset alias.st边界
alias 只是文本替换,不能写复杂逻辑。需要条件判断、循环,写 shell 脚本或函数,放到 PATH 里,alias 指向脚本。
git bisect:二分定位 bug
要解决什么:main 上有个 bug,但不知道是哪次提交引入的。历史有 500 个提交,一行行看太慢。
git bisect 用二分查找:每次让你判断“这个提交是好的还是坏的”,每次排除一半, log2(500) ≈ 9 次就能定位。
手动 bisect
git bisect start
git bisect bad # 当前 HEAD 是坏的
git bisect good v1.0 # v1.0 是好的Git 会检出一个中间的提交,让你测试。测试完告诉 Git:
git bisect good # 这个提交没问题
# 或
git bisect bad # 这个提交有问题Git 继续缩小范围,直到找到第一个坏提交:
a1b2c3d is the first bad commit结束:
git bisect reset回到开始 bisect 前的状态。
自动 bisect
要解决什么:手动测试还是麻烦。如果有一个脚本能自动判断“好坏”,让 Git 自己跑完整个二分过程。
git bisect run ./test.shtest.sh 返回 0 表示好,非 0 表示坏。Git 自动跑完整个二分过程,直接告诉你第一个坏提交。
一个例子,用 npm test 判断:
git bisect start
git bisect bad HEAD
git bisect good v1.0
git bisect run npm testGit 会自动检出每个中间提交,跑 npm test,根据结果判断好坏,最后输出第一个失败提交。
bisect 的边界
需要能可靠判断好坏。判断标准不明确,bisect 结果不可信;
需要可复现。bug 时有时无,bisect 会误判;
提交历史里有合并提交时,bisect 可能跳过某些提交。可以用
--first-parent只看主干。
一个习惯:发现 bug 时,先想“能不能写个脚本判断好坏”。能写,就用 bisect run,比手动快一个数量级。
git blame:谁改的、什么时候改的
要解决什么:看到某行代码,想知道它是哪个提交、谁、什么时候改的。
git blame 文件名输出:
a1b2c3d4 (张三 2026-01-15 10:30:00 +0800 1) function login() {
e5f6a7b8 (李四 2026-02-20 14:20:00 +0800 2) checkPassword();每行前面是提交哈希、作者、时间、行号。
常用选项
# 忽略空白改动
git blame -w 文件名 # 只看某个范围
git blame -L 10,20 文件名 # 检测代码移动(跨文件)
git blame -C 文件名blame 的痛点:格式化提交
如果某次提交只是跑了格式化工具,所有行都变成“这次提交改的”,blame 就没用了。
单个提交临时忽略:
git blame --ignore-rev <格式化提交哈希> 文件名更系统的做法:在仓库根目录建 .git-blame-ignore-revs,每行一个提交哈希:
# 格式化提交
a1b2c3d4e5f6...
b2c3d4e5f6a7...然后配置:
git config blame.ignoreRevsFile .git-blame-ignore-revs之后 git blame 自动忽略这些提交,把每一行归到真正改它的提交上。 GitHub 也支持这个文件,网页上的 blame 视图同样生效。
blame 的定位
blame 用来追溯上下文,不是用来“追责”。它的价值是:看到某行代码时,能快速知道“为什么这么写”, 然后 git show <哈希> 看完整提交信息。