把做过三遍的事写下来:第一个可以重跑的脚本
把日志整理留成文件,再给它参数、输入检查和明确的输出位置。用缺失文件、空日志与重复执行,检查脚本说的“成功”。

你已经能从日志里筛错误、取模块、排序计数。第二天又来一份日志,你翻历史命令,把文件名改掉,再跑一遍。
做了第三次,值得把这套操作写下来了。
先给它一个很小的目标:接收一份日志,生成一份能核对的摘要。 暂时不需要把它写成通用工具箱。
先把一条命令留成文件
先只数错误记录。保存为 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,给自己写出的脚本拍一张快照。输入数据、生成结果与操作过程各有自己的位置,你也就有了一次可以解释、重做和修改的小工作流。