自动化与效率工具

开场:哪些事值得自动化

日常开发里有几类事反复出现,每次手动做既慢又容易忘:

  • 提交前检查代码格式、跑静态检查;

  • 提交信息格式是否规范;

  • 推送前跑一遍单元测试;

  • 推送后自动跑 CI、自动部署;

  • 找“这个 bug 是哪次提交引入的”。

前四类用 hooks + CI 解决,第五类用 git bisect 解决。 另外顺手配几个 alias 缩短高频命令,用 git blame 追溯某行代码的来历。

Git Hooks 是什么

要解决什么:有些检查每次提交/推送前都该做,但靠人记不住,想让 Git 在特定动作前后自动执行。

Hook 就是“钩子”:Git 在特定动作前后,自动执行你指定的脚本。分两类:

类型

在哪执行

常见钩子

客户端钩子

本地仓库

pre-commit、commit-msg、pre-push

服务端钩子

远程仓库

pre-receive、post-receive,一般由平台管理

钩子脚本放在 .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。

其他常见钩子

钩子

时机

典型用途

post-commit

提交创建后

通知、记录日志

pre-rebase

rebase 前

检查分支是否允许 rebase

post-checkout

切分支 / 检出后

安装依赖、生成配置

post-merge

合并后

安装依赖、迁移数据库

跳过钩子

git commit --no-verify
git push --no-verify

但不要养成习惯。钩子被跳过,等于检查没做。紧急情况用一次,事后补上。

钩子不能当安全边界

客户端钩子可以被 --no-verify 绕过,也可以被直接删掉。所以:

  • 钩子用于提高效率、提前发现问题;

  • 真正的强制检查放在 CI / 服务端钩子上;

  • 密钥扫描这类安全要求,不能只靠 pre-commit。

团队共享钩子

要解决什么:.git/hooks/ 不进版本控制,怎么让团队都用同一套钩子?

方案一:把钩子放进仓库,用配置指向它

在仓库里建 githooks/ 目录,放钩子脚本,提交进版本控制。然后配置:

git config core.hooksPath githooks

Git 会去 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

逐段解释:

字段

含义

name

workflow 名字,显示在 GitHub 页面上

on

触发条件。这里是推送到 main、或向 main 提 PR 时触发

jobs

一个 workflow 可以包含多个 job,并行或串行执行

runs-on

运行环境

steps

步骤列表

uses

使用现成的 action,比如 actions/checkout 检出代码

run

执行 shell 命令

常用触发事件

on: push: branches: [main, develop] pull_request: branches: [main] schedule: - cron: '0 2 * * *' # 每天凌晨 2 点 workflow_dispatch: # 手动触发

常用 action

action

作用

actions/checkout

检出代码,几乎每个 workflow 都需要

actions/setup-node / setup-python / setup-go

安装语言环境

actions/cache

缓存依赖,加速构建

actions/upload-artifact

上传构建产物

查看运行结果

推送后,在 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.sh

test.sh 返回 0 表示好,非 0 表示坏。Git 自动跑完整个二分过程,直接告诉你第一个坏提交。

一个例子,用 npm test 判断:

git bisect start
git bisect bad HEAD
git bisect good v1.0
git bisect run npm test

Git 会自动检出每个中间提交,跑 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 <哈希> 看完整提交信息。