命令行与文本处理 / 系统课时

怎样同时输出终端和日志文件

怎样同时输出终端和日志文件

自动化脚本既要让操作者实时看到进度,又要留下可追溯的运行记录。直接使用重定向会让输出只进入文件,而 tee 可以把同一份标准输出同时发送到终端和日志文件,适合备份、批处理和部署脚本的运行日志。

学习目标

  • 使用 tee 同时显示并保存脚本输出
  • 区分覆盖写入与追加写入的适用场景
  • 在管道失败时正确判断脚本执行结果

tee 怎样复制输出

普通重定向 > 会把标准输出从终端改送到文件,因此执行过程中看不到进度。tee 位于管道中间:它从标准输入读取数据,一份写入指定文件,另一份继续输出到标准输出,所以终端仍然能够显示内容。

最常见的结构是:

bash
command | tee run.log

这里 command 的标准输出先进入管道,再由 tee 同时写入 run.log 和终端。默认情况下,如果 run.log 已经存在,其原内容会被覆盖。

在脚本中同时显示并记录

下面的脚本模拟一个批处理任务,并把运行过程写入 logs/batch.log。示例使用固定的相对路径,复制后即可运行。

bash
#!/usr/bin/env bash
set -euo pipefail

mkdir -p logs

{
  echo "开始批处理"
  echo "处理 customer.csv"
  echo "处理 orders.csv"
  echo "批处理完成"
} | tee logs/batch.log

预期输出

text
开始批处理
处理 customer.csv
处理 orders.csv
批处理完成

执行结束后,终端会看到上述四行内容,logs/batch.log 中也会保存完全相同的文本。这种写法适合希望观察任务进度,同时保留本次运行记录的脚本。

追加日志而不是覆盖

定时任务通常需要连续保留多次执行记录,这时使用 tee -a。-a 表示 append,不会清空已有文件。

bash
printf '%s\n' "新一轮任务开始" | tee -a logs/batch.log

预期输出

text
新一轮任务开始

执行后,这一行既显示在终端,也追加到 logs/batch.log 末尾。是否使用 -a 应由日志策略决定:每次运行只保留最新结果时直接用 tee;需要历史记录时使用 tee -a,并配合日志轮转避免文件无限增长。

不要忽略管道中的失败

脚本加入 tee 后,命令会形成管道。默认 Bash 更容易让人只注意管道最后一个命令的退出状态:前面的业务命令失败,而 tee 成功写文件时,错误可能被误判为整体成功。

因此自动化脚本通常应启用 pipefail:

bash
set -o pipefail
false | tee logs/result.log
echo "exit=$?"

预期输出

text
exit=1

启用 pipefail 后,只要管道中的关键命令失败,整个管道就能返回非零状态,更适合被 CI、定时任务或上层调度系统检测。tee 解决的是“输出去哪里”的问题,而 pipefail 解决的是“失败能否被正确发现”的问题,两者经常需要一起使用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样同时输出终端和日志文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通