Linux tee 命令:同时显示输出、保存文件与追加日志

tee 把标准输入复制到标准输出,同时把同一内容写入一个或多个文件,适合边查看命令结果边保存记录,也能在管道中保存中间数据。默认会覆盖目标文件;要在已有记录后追加,应使用 -a。

标准输出是命令通常用于输出结果的通道,标准错误是报告错误的独立通道。普通管道 | 只连接前一个命令的标准输出;tee 的标准输出若仍连着终端,才会显示在屏幕上,若连着后续命令,就会继续交给该命令处理。

基本语法与输出文件

command | tee [OPTION]... [FILE]...

这里的 command、OPTION 和 FILE 是占位符。每个文件操作数都是输出文件,不是输入文件:例如 tee notes.txt 会等待标准输入,并可能清空已有的 notes.txt。读取文件内容应使用输入重定向或上游命令;不能把待保留的输入文件误当成输出目标。

可同时指定多个输出文件,例如 printf 'ok\n' | tee first.log second.log,两个文件都会收到同一行,标准输出也会收到一份。没有文件操作数时,内容只复制到标准输出。实现和版本可能不同,可用 tee --version、man tee 核对本机;GNU 长选项和下面的 -p 不能视为所有系统都支持。

完整练习:显示、保存与追加

准备独立目录并保存时间。下面整段在当前目录新建 tee-demo,准备三行名字并运行原例中的时间命令。需要 Bash、date、sort、head 和 tee;后续文件示例都在该目录执行。若目录已存在,命令会停止,请另选未使用的名称,保留旧练习。

mkdir tee-demo && cd tee-demo && (
  set -e
  set -o noclobber
  printf 'Charlie\nAlice\nBob\n' > names.txt
  date | tee run-time.txt
)

终端显示一行当前时间,run-time.txt 保存同一行。时间格式受本机区域设置影响,因此不应把示例日期当成固定预期结果。用 cat run-time.txt 查看文件;再次普通写入同一个输出路径会替换原内容。

追加已有日志。以下命令保留第一行时间,并在后面增加一次新的时间记录:

date | tee -a run-time.txt

终端只显示本次产生的一行,文件现在有两行;可用 wc -l run-time.txt 确认。-a 仍可在文件不存在时创建文件,但不会自动创建缺少的父目录,也不会绕过文件权限。

保存排序后的中间结果。对刚准备的三行名字运行:

sort names.txt | tee names.sorted | head

终端依次显示 Alice、Bob、Charlie,names.sorted 也有这三行。这里 head 默认最多取十行,所以三行练习能完整传递;输入较大时,不能由这个小例子推断文件一定保存完整,下面会说明提前关闭管道的问题。按键排序的更多用法可参阅 sort 命令的排序与区域设置说明。

核对屏幕与文件中的相同内容

继续在练习目录运行一个结果固定的例子:

printf 'status=ok\n' | tee result.txt

屏幕会显示下面一行;result.txt 也保存这一行及末尾换行,可用 cat result.txt 核对:

status=ok

若再运行相同命令,文件仍只有一行;若改用 printf 'status=ok\n' | tee -a result.txt,就会追加一行。重定向与 tee 的覆盖行为要分开理解:Bash 的 set -o noclobber 可保护普通 > 重定向,但不能阻止 tee 自己打开文件并覆盖。练习目录隔离才是本例避免碰到已有文件的主要措施。

主要选项与提前关闭的管道

选项 作用及适用范围
-a 在指定文件末尾追加,不截断已有内容。
-i 忽略 SIGINT 中断信号;不代表忽略所有信号或写入错误。
-p GNU 扩展,默认采用 warn-nopipe 输出错误模式,适合下游可能提前退出的管道。

大文件经过 head 时,下游读够行数便可能退出。GNU tee 默认遇到管道写入错误会立即退出,保存文件因此可能不完整;是否发生受数据量和时序影响。使用 GNU 实现时,可改为 sort names.txt | tee -p names.sorted | head,让文件输出在下游关闭后继续完成。

-p 不能解决磁盘空间不足、权限不足或输入命令本身失败。GNU Coreutils 项目提供的 tee 手册页列出了 --output-error 的各模式;对于带 nopipe 的模式,若所有输出都变为断开的管道,仍会立即退出。需要完整日志时,应核对文件及各命令状态,不能只看屏幕上出现了几行。

权限、错误输出与保存安全

权限由执行写入的进程决定。sudo command > /protected/file 中,重定向由当前 Shell 先执行,可能在启动命令前就因权限不足而失败。确认确实需要写入哪个管理员文件后,command | sudo tee file 可让 tee 以提升后的权限打开目标;需要追加时使用 sudo tee -a。这些是结构示意,不要直接拿系统配置文件练习,也不要把 sudo 当作修复所有路径错误的方法。

tee 默认还会把输入写到标准输出。记录密钥或令牌时,终端、后续管道和日志都可能泄露内容;不需要显示时可将它的标准输出重定向到 /dev/null,但这不会删除已写入文件的敏感数据,仍需控制目标和权限。

标准错误要在上游合并。例如 command 2>&1 | tee combined.log 会把该命令的标准错误并入标准输出后一起保存。若把 2>&1 放在 tee 后面,改变的是 tee 自己的错误通道;不同 Shell 的简写也不一定通用。上游程序若自身缓冲输出,使用 tee 不保证日志立即出现。

检查状态并保留输入。tee 成功返回 0,出错返回非零;Bash 默认用管道最后一个命令的状态作为整条管道状态,上游失败可能被后面的成功掩盖。脚本可考虑 set -o pipefail,或在管道结束后立即检查 PIPESTATUS,再处理记录。不要使用 cat input.txt | tee input.txt,也不要让重定向输出覆盖输入路径;同一路径、硬链接或符号链接指向同一个文件都可能破坏原数据。先保存到新的路径并核对结果。

常见问题

tee 会自动保存标准错误吗?

不会。它保存的是标准输入中收到的数据;普通管道默认只传递上游的标准输出。若确需合并错误,应在上游命令处明确使用重定向,并确认保存内容不含敏感信息。

规范与本机手册

POSIX(可移植操作系统接口)tee 规范规定了复制输入、追加和忽略中断的基本行为。上面的 GNU 手册补充了输出错误模式;部署脚本前还应通过本机手册确认实现、版本和选项。