0%
✍️ Insight

把做过三遍的事写下来:第一个可以重跑的脚本

把日志整理留成文件,再给它参数、输入检查和明确的输出位置。用缺失文件、空日志与重复执行,检查脚本说的“成功”。

你已经能从日志里筛错误、取模块、排序计数。第二天又来一份日志,你翻历史命令,把文件名改掉,再跑一遍。

做了第三次,值得把这套操作写下来了。

先给它一个很小的目标:接收一份日志,生成一份能核对的摘要。 暂时不需要把它写成通用工具箱。

先把一条命令留成文件

先只数错误记录。保存为 basic.sh:

#!/usr/bin/env bash
grep -F ' ERROR ' run.log | wc -l

运行:

bash basic.sh

这次 Bash 从文件里读命令,结果仍是六条。脚本没有另一套神秘语言;你先把已经敲过的操作保存起来。

问题很快出现:你传入另一份日志,结果却没有变。

bash basic.sh "data/run two.log"

因为 basic.sh 的正文仍写着 run.log。给了参数,不代表脚本自动使用它。

让脚本使用你交进来的路径

把第二行改成:

grep -F ' ERROR ' "$1" | wc -l

保存为 args.sh。$1 是调用脚本时的第一个参数;$2 是第二个。双引号仍在做上一课那件事:把整个路径留在一个参数里。

外面调用时,也要保住这个路径:

bash args.sh "data/run two.log"
比较写死文件名的版本与使用参数的版本,再故意拆开带空格的路径。

观察窗里有 $#,它是参数的数量。去掉引号,data/run two.log 会变成两个参数:$1 是 data/run,$2 是 two.log。脚本拿到的就不是你以为交进去的那份文件。

注意两层引号的作用:调用处决定脚本收到几个参数;脚本里的 "$1" 决定随后交给 grep 的路径怎样组成。只改一处,不能补救另一处已经丢失的边界。

bash 文件,与直接执行文件

本篇用 bash args.sh 明确选择解释器,不要求文件具有执行权限。

直接写 ./args.sh 时,则需要执行权限,并由开头的 shebang 指定解释器。#!/usr/bin/env bash 通过环境里的搜索路径寻找 bash;这又接回了上一课的 PATH。先把显式调用做顺,再考虑直接执行。

先把输入检查清楚,再开始干活

运行 bash args.sh missing.log,你会再次遇到上一课的陷阱:grep 读取失败,wc 却正常打印零行,整条默认管道还可能返回零。

现在给脚本加一道入口检查。先看参数数量:

if [ "$#" -ne 1 ]; then
  printf '用法: bash checked.sh 日志文件\n' >&2
  exit 2
fi

if 根据条件的状态选择是否执行里面的命令;[ ... ] 是条件检查,这里 -ne 表示数字不相等。它们之间的空格是语法的一部分。

数量不对,就把用法写到标准错误,并退出。这里约定状态 2 表示调用方式不对;这是这个脚本自己的约定,不能推广成所有程序的统一含义。

再检查输入确实是可读的普通文件:

if [ ! -f "$1" ] || [ ! -r "$1" ]; then
  printf '无法读取: %s\n' "$1" >&2
  exit 1
fi

-f 检查普通文件,-r 检查可读,! 取反。只要任一检查不满足,就先停止。只有通过以后,才运行原来的检索与计数。

把缺少参数、缺失文件与确实存在的空日志分开检查。

这时三种情况有了清楚的区别:

输入情况输出与状态
没交参数用法写到标准错误,状态 2
交了读不到的路径错误说明写到标准错误,状态 1
交了存在的空日志正常打印 0,状态 0

第三种不是失败。“没有错误记录”本来就可以是一份有效结果。

入口检查也不是对未来的保证:通过以后,文件仍可能被删除,或者发生读取错误。因此后面的关键步骤仍需要检查状态。

给结果一个明确的位置

接下来从“数行”回到“按模块生成摘要”。这个版本接收两个参数:日志文件和已经存在的输出目录。

bash report.sh run.log out

脚本内部用两个名字接住参数:

input=$1
out=$2
target="$out/summary.txt"

赋值不会自动打开文件。随后仍要检查:是不是恰好两个参数、输入是否可读、输出目录是否存在;目标若与输入指向同一个文件,也要拒绝。

最终版本还把检索结果先留在变量里:

matches=$(grep -F ' ERROR ' "$input")
code=$?

这里的 $(...) 执行里面的命令,把标准输出放到赋值里;末尾的换行会被去掉。这次赋值的状态来自其中的检索命令,所以要立刻保存 $?,再执行别的命令。

根据 grep 的约定,0 表示有匹配,1 表示没有匹配,更高的状态可能是错误。最终版本把没有匹配写成空摘要;遇到检索错误则在写摘要以前退出。有匹配时,再把这些行交给取列、排序和计数。

生成、读回、重跑,再用缺失输入检查旧摘要是否保留。

为什么同一份输入重跑两次,摘要里不会多出一份重复记录?因为这份结果是重新生成后覆盖写入,用的是 >,不是往旧摘要里追加。

这里的覆盖是一个明确的选择:out/summary.txt 专门放可重建的派生结果。原始日志是输入,脚本不应把它当成输出目标。

最终版本做了哪些检查,还有什么边界?

完整代码可在练习中展开或从下面下载。它检查参数、可读输入、输出目录以及输入/目标是否为同一文件;区分 grep 的空匹配与错误;计数管道开启 pipefail,并检查写入状态。

它仍不是完整的生产日志系统:沿用本篇单空格分列的格式,不处理任意 CSV;写入过程中磁盘空间耗尽等失败,仍可能留下不完整的摘要。需要在这类失败时也保留旧结果,可以进一步学习临时文件、验证和原子替换。

这一篇验收的是正常输入的可重复生成,以及入口检查失败时不触碰旧摘要。不要把这个范围扩大成“任何失败都能自动恢复”。

把脚本带到真实终端

下载 basic.sh、args.sh、checked.sh 和 最终 report.sh。输入可以用前一篇的练习日志。

把脚本和 run.log 放进一个新的练习目录,再创建一个空的 out 目录。亲手完成这张验收表:

操作应检查的结果
生成摘要,读回文件sensor 3 次、solver 2 次、mesh 1 次
对同一份输入再生成一次内容相同,仍是三项
使用缺失输入非零状态,原摘要内容保留
用存在的空日志生成成功,摘要为空
把输入指定为目标摘要本身拒绝执行,输入没有被覆盖

每次运行后立即查退出状态,再检查文件内容。命令安静、文件存在、输出里有“写入”字样,都不能单独替代这两项核对。

最后,在真实电脑上从一个空白文件重写入口检查和那条已经熟悉的管道。忘记语法可以查;重点是你能说明每个参数、每个退出分支和每个写入目标为什么存在。

相关机制可核对 Bash 的脚本与位置参数、条件检查及命令替换。浏览器模型只运行上述已给出的版本,不具备完整 Bash 解释器;下载代码与这些版本保持一致,并用真实 Bash 检查示例结果。技术说明核验于 2026-10-03。

从这里回到渐进式 Git,给自己写出的脚本拍一张快照。输入数据、生成结果与操作过程各有自己的位置,你也就有了一次可以解释、重做和修改的小工作流。