1. 项目概述为什么说tee是Linux管道操作的“瑞士军刀”在Linux命令行世界里数据流就像一条奔腾不息的河流。我们常常需要将上游命令的输出既送到下游继续处理又同时保存一份到文件里。比如你想把一个耗时很长的编译过程日志既实时显示在屏幕上又完整地记录到日志文件中方便后续排查。这时候如果你只知道用重定向输出就只会默默写入文件屏幕上一片漆黑你完全不知道进程是卡住了还是在正常运行。而管道|虽然能把数据传给下一个命令但原始数据就“消失”了。这个看似简单的需求恰恰是tee命令大显身手的舞台。tee这个名字很有意思它源于管道工使用的“T型三通管”。想象一下水管上的一个三通接头水流从一端进来然后同时分向另外两个方向流出。tee命令在数据流中扮演的角色一模一样它从标准输入stdin读取数据然后同时写入标准输出stdout和一个或多个文件。这个“一分为多”的能力让它成为了连接、调试和记录命令行操作的利器。无论是系统管理员监控服务状态还是开发者调试复杂的数据处理流水线tee都是工具箱里不可或缺的一件。很多人刚开始接触Linux时会觉得重定向和管道已经足够强大tee似乎是个可有可无的“高级”命令。但真正用起来你会发现它极大地提升了命令行工作的灵活性和可控性。它解决的不仅仅是“边看边存”的问题更是关于数据流控制、中间结果快照和复杂管道调试的核心需求。接下来我们就深入拆解这个命令从基础用法到高阶技巧让你彻底掌握这把“瑞士军刀”。2. 核心需求解析tee命令到底解决了哪些痛点要理解tee的价值我们得先回到命令行数据处理的几个典型场景。这些场景单用或|都会很别扭而tee则能优雅地解决。2.1 实时监控与持久化记录的矛盾这是最经典的需求。假设你在部署一个应用需要执行一个安装脚本install.sh。这个脚本输出很多信息包括进度、警告和错误。你既想盯着屏幕看实时进度又必须把完整的输出保存下来万一安装失败可以回头分析日志。只用./install.sh install.log。你的屏幕将一片寂静只能干等或者用tail -f install.log在另一个终端看但这毕竟不是真正的“实时”且增加了操作复杂度。只用|./install.sh | grep -i error。你只能看到错误行但安装过程中的其他有用信息如成功步骤、配置详情都丢失了。使用tee./install.sh | tee install.log。完美所有输出既实时滚动在屏幕上又被一字不差地写入install.log文件。你可以实时监控出了问题也有完整日志可查。2.2 管道中间环节的调试与快照在复杂的管道命令中数据经过多个命令的转换。当结果不符合预期时你很难确定是哪个环节出了问题。tee可以在管道的任意位置插入将中间数据“分流”保存到一个文件方便你检查。 例如分析日志文件cat app.log | awk {print $1} | sort | uniq -c | sort -rn。你想看看经过awk处理后的数据是什么样的。没有tee你只能把管道拆开分步执行。有了tee可以这样做cat app.log | awk {print $1} | tee intermediate.txt | sort | uniq -c | sort -rn。这样最终结果照常输出而awk处理后的中间结果被保存到了intermediate.txt中随时可以查看。2.3 向多个目的地分发数据有时你需要将一份数据同时写入多个文件。比如生成一份报告需要同时保存一份原始副本、一份给团队的共享副本和一份带时间戳的归档副本。手动复制三次既低效又容易出错。tee可以指定多个文件参数一次写入所有目标。 命令形如generate_report.sh | tee report_latest.txt shared/report.txt archive/report_$(date %Y%m%d).txt。数据流只生成一次却被同时复制到了三个文件中高效且原子性要么全部成功要么全部失败。2.4 提升需要特权的管道操作的安全性这是一个容易被忽略但非常重要的场景。假设你需要用sudo执行一个命令并将其输出重定向到一个普通用户没有写入权限的目录下的文件。sudo dmesg /var/log/my_dmesg.log这个命令会失败因为重定向是由当前用户的shell执行的而当前用户没有向/var/log/写入的权限。 正确的做法是sudo dmesg | sudo tee /var/log/my_dmesg.log /dev/null。这里dmesg以root权限执行其输出通过管道传给tee而tee同样以sudo提权从而获得了向目标路径写入文件的权限。我们将tee自身的标准输出重定向到/dev/null是为了避免屏幕上再显示一遍因为dmesg的输出已经显示过了。这个技巧在编写需要写入系统目录的安装或配置脚本时非常有用。注意tee默认会覆盖目标文件。如果你希望追加内容必须使用-a选项这是新手常犯的错误之一误操作可能导致重要日志被清空。3. 命令语法与选项深度剖析掌握了为什么用我们再来彻底搞清楚怎么用。tee的语法非常简洁但每个选项都有其明确的用途。3.1 基础语法格式tee [OPTION]... [FILE]...[OPTION]命令选项控制tee的行为。[FILE]...一个或多个文件名。tee会将输入数据写入这里指定的所有文件。如果文件不存在则创建它如果存在则根据选项决定是覆盖还是追加。3.2 核心选项详解-a, --append作用不清空目标文件而是将输入数据追加到文件末尾。为什么需要它这是与默认行为覆盖对应的关键选项。想象一下监控场景你每隔一段时间运行一个检测脚本希望把所有结果累积到一个日志文件中。如果不用-a每次运行都会覆盖上次的日志历史数据就全丢了。示例对比echo Run 1 | tee log.txt- log.txt 内容为Run 1echo Run 2 | tee log.txt- log.txt 内容变为Run 2覆盖了echo Run 2 | tee -a log.txt- log.txt 内容为Run 1\nRun 2追加-i, --ignore-interrupts作用忽略中断信号通常是CtrlC。为什么需要它在有些严谨的日志记录场景下你希望即使前台命令被中断tee进程也能坚持把已经接收到的数据完整写入文件后再退出避免日志文件因中断而损坏或不完整。这个选项不常用但在编写高可靠性的脚本时可以考虑。-p(部分tee实现如 GNU coreutils 中的tee支持)作用诊断写入错误时不修改管道的行为。这是一个更偏底层的选项用于处理tee在写入文件出错时如何影响从标准输入读取数据的行为。对于绝大多数日常应用可以不用深究。--output-error[MODE](GNU coreutils 扩展)作用指定写入文件发生错误时的行为模式。模式warn默认对每个写入错误输出警告信息但继续处理其他文件。warn-nopipe类似warn但如果输出到管道时发生错误则直接退出而不警告。exit遇到任何写入错误立即退出。exit-nopipe遇到文件写入错误立即退出但忽略管道错误。为什么需要它当tee同时写入多个文件而其中一个目标比如一个网络挂载的磁盘突然不可用时这个选项决定了脚本是继续运行记录其他文件还是立即失败。在自动化脚本中根据你对错误容忍度的要求来设置这个选项很重要。3.3 输入与输出流理解tee必须理解它的数据流标准输入 (stdin)tee的唯一数据来源。通常由管道|提供或由输入重定向提供。标准输出 (stdout)tee总会将输入数据原样输出到这里所以你能在屏幕上看到。你可以用或|再次重定向它的标准输出。文件参数指定的一个或多个文件是数据的额外副本目的地。一个关键点是tee写入文件和写入标准输出是并行的而不是先写文件再显示。这意味着即使写入文件很慢比如磁盘繁忙也不会过度阻塞数据在管道中的流动当然一定程度的影响是存在的。4. 经典应用案例场景详解理论说再多不如看实战。下面我们通过一系列由浅入深的案例看看tee如何解决真实问题。4.1 案例一基础保存与监控场景编译一个大型C项目并保存编译日志。make -j4 | tee build.log拆解make -j4启动4个并行任务进行编译其输出包括编译命令、警告、错误通过管道传给tee。tee将其同时显示在屏幕上让你实时看到哪个文件在编译、是否有错误并写入build.log文件。实操心得编译出错时错误信息会一闪而过。有了build.log你可以用grep -n error build.log或less build.log仔细查看错误上下文比在滚动屏幕上找要方便得多。4.2 案例二管道调试与中间检查场景处理一个CSV文件提取第二列排序并计数但怀疑数据清洗awk步骤有问题。cat data.csv | awk -F, {print $2} | tee column2.tmp | sort | uniq -c | sort -nr result.txt拆解原始管道是cat - awk - sort - uniq - sort - result.txt。我们在awk处理后插入了tee column2.tmp。这样最终排序计数结果存入result.txt而awk刚提取出的原始第二列数据被保存到column2.tmp。如果最终结果不对打开column2.tmp就能验证awk命令是否正确提取了数据。注意事项中间文件如column2.tmp最好加上.tmp后缀或在特定目录并在脚本最后考虑清理避免留下垃圾文件。4.3 案例三多目的地写入与权限提升场景更新系统并同时生成更新日志日志需要放在普通用户无权限的/var/log/下。sudo apt update | sudo tee /var/log/apt_update_$(date %Y%m%d).log或者如果你不想在屏幕上看到apt update的输出通常很长只关心是否有错误sudo apt update 21 | sudo tee /var/log/apt_update.log /dev/null拆解sudo apt update以root权限执行更新。21将标准错误(stderr)合并到标准输出(stdout)这样错误信息也会被记录。| sudo tee ...通过管道将合并后的输出传给teetee也需要sudo权限才能写入/var/log/。 /dev/null将tee自身的标准输出即它从管道读到的所有数据丢弃不显示在屏幕上。因为我们已经把数据存到文件了。关键点这里用了两个sudo。第一个是apt命令需要的第二个是tee写文件需要的。这是解决权限问题的标准模式。4.4 案例四与xargs结合实现复杂分发场景有一个文件urls.txt里面每行是一个URL你想下载所有这些URL对应的文件并且将每个下载命令的执行输出既显示出来又分别记录到以URL命名的日志文件中。cat urls.txt | xargs -I {} bash -c wget -O downloads/$(basename {}) {} 21 | tee logs/$(basename {}).log拆解这个命令稍复杂但展示了tee在子shell和循环中的用法。cat urls.txt | xargs -I {}读取每一行URL用{}代替。bash -c ...为每个URL启动一个子shell执行命令。wget -O ...下载文件21将错误输出也合并。| tee logs/$(basename {}).log在子shell的管道中将wget的输出同时显示并记录到以URL文件名命名的日志文件中。为什么强大它为每个并发下载任务创建了独立的日志调试时能精准定位是哪个URL出了问题。4.5 案例五在脚本中记录完整会话配合script命令场景你需要记录一次完整的终端交互会话包括输入的命令和所有的输出用于审计或教学。script -c “bash” session.log | tee terminal_output.log或者更常见的用法是直接启动script它会在后台默默记录script -a my_session.log # 此时开始你所有的输入和输出都会被记录到 my_session.log # 输入 exit 或 Ctrl-D 结束记录拆解script命令本身就是一个强大的会话记录器。上面第一种用法中-c “bash”是启动一个子shellscript记录这个子shell的所有IO到session.log。再通过管道tee到另一个文件相当于做了一个实时备份或分流。第二种用法是交互式记录-a表示追加模式。与tee的关系script本身已经实现了tee的核心功能分流记录但这里演示了如何将两个工具链式使用。有时你可能需要script的原始时序记录同时又想用tee做实时处理。5. 高级技巧与组合拳掌握了基本用法我们来点“骚操作”让tee在更复杂的场景下发挥威力。5.1 向多个进程分发数据命名管道 FIFO这是tee一个非常高级的用法将一份数据同时喂给多个需要标准输入的命令。 假设你有两个处理工具processor_a和processor_b都需要从标准输入读取同一份原始数据。# 创建命名管道 mkfifo fifo_a fifo_b # 启动消费者进程从各自的管道读取 processor_a fifo_a pid_a$! processor_b fifo_b pid_b$! # 生产者产生数据并用 tee 分发给两个命名管道 generate_data | tee fifo_a fifo_b /dev/null # 等待后台进程结束 wait $pid_a wait $pid_b # 清理命名管道 rm fifo_a fifo_b原理解析命名管道FIFO是一种特殊的文件它没有存储能力只是连接两个进程的通道。tee可以像写普通文件一样向 FIFO 写入数据而数据会立即被从 FIFO 另一端读取的进程消费。这样我们就实现了“一发两收”。注意事项必须确保消费者进程processor_a/b在生产者开始写入前就已经启动并在等待读取否则tee可能会阻塞。通常通过后台启动 () 和wait命令来控制顺序。5.2 忽略标准输出仅用于文件写入或管道分发有时你只关心把数据写入文件或分发给其他管道不想在终端上看到任何输出。这很简单将tee的标准输出重定向到/dev/null。verbose_command | tee /dev/null important_output.txt # 错误 verbose_command | tee important_output.txt /dev/null # 正确关键点tee的命令行参数文件和它的标准输出是两条独立的路径。重定向操作的是标准输出。所以第一条命令是错误的它试图把tee的输出重定向到文件但tee写入文件是通过参数important_output.txt实现的不是标准输出。第二条命令才是正确的数据通过tee写入important_output.txt同时tee的标准输出被丢弃。5.3 在循环和条件判断中使用tee在 shell 脚本的循环中如果你想记录每次迭代的输出同时又能看到实时进度tee是唯一选择。#!/bin/bash LOG_FILEprocessing.log echo 开始处理任务列表... | tee -a $LOG_FILE while IFS read -r item; do echo “处理项目: $item” | tee -a “$LOG_FILE” process “$item” 21 | tee -a “$LOG_FILE” # 21 确保错误信息也被捕获和记录 done item_list.txt echo “所有任务处理完毕。” | tee -a “$LOG_FILE”优势脚本中所有的echo和process命令的输出都会同时出现在终端和日志文件里。调试脚本时你可以看着终端跑出错了也有完整的日志追溯每一步。5.4 与grep、awk、sed等过滤工具结合tee经常和过滤工具一起用实现“保存原始查看精华”的效果。tail -f /var/log/syslog | tee raw_syslog.tmp | grep -i “error”这个命令持续跟踪系统日志tail -f将所有原始日志行保存到raw_syslog.tmp随着tail -f持续追加同时只将包含“error”关键词的行显示在屏幕上。这样你既不会错过任何错误信息又拥有了一份完整的上下文日志供深度分析。6. 常见问题、陷阱与排查指南即使明白了原理在实际使用tee时还是会踩一些坑。下面是我总结的常见问题清单和解决方案。6.1 文件被覆盖了问题描述想追加日志却用了tee log.txt而不是tee -a log.txt导致之前的日志全部丢失。原因tee默认行为是覆盖truncate已存在的文件。解决方案养成习惯如果不确定或者明确需要追加总是加上-a选项。脚本防护在重要的脚本中如果要写入已存在的文件可以先判断或者使用重定向的变通方案但这样会失去屏幕输出。更稳妥的方法是使用带时间戳的新文件名。LOG_FILE“app_$(date %Y%m%d_%H%M%S).log” my_command | tee “$LOG_FILE”6.2 为什么sudo command file不行非要tee问题描述sudo echo “text” /root/file报权限错误。原因深度解析重定向符号是当前 shell 解释执行的。当你输入这行命令时发生的事是这样的Shell 解析命令行发现 /root/file。Shell以当前用户身份尝试打开/root/file准备写入。由于当前用户不是 root权限被拒绝。此时sudo甚至还没开始执行echo。解决方案必须让打开文件这个动作也以 root 权限执行。有两种方法使用tee推荐echo “text” | sudo tee /root/file /dev/null。这里tee在sudo下运行所以它能以 root 权限打开文件。使用sh -csudo sh -c ‘echo “text” /root/file’。这样整个字符串内的重定向都在sudo启动的子 shell 中执行因此具有 root 权限。但这种方法不如tee灵活尤其是在需要同时看到输出时。6.3tee导致管道命令提前结束或行为异常问题描述在管道中使用tee后发现下游命令比如sort好像没收到全部数据或者脚本提前结束了。可能原因信号处理tee默认情况下如果写入文件出错如磁盘满、权限不足它会向管道报告一个错误并可能导致上游命令数据生产者收到 SIGPIPE 信号而终止。这就是--output-error选项要控制的场景。缓冲区标准输出和文件写入的缓冲区策略可能不同。虽然tee尽力同步但在极端性能或异常情况下可能会观察到顺序或完整性问题。排查与解决使用--output-errorwarn观察是否有写入错误。对于关键管道可以在tee前后使用stdbuf命令调整缓冲区如stdbuf -o0设置标准输出无缓冲但这会增加系统调用开销。最简单的测试方法是用一个产生大量数据的小脚本对比使用和不使用tee的结果是否一致。6.4 性能考量tee会拖慢管道吗客观影响会但通常微乎其微。tee需要将数据复制一份并执行额外的写入系统调用。对于每秒GB级的数据流这个开销是明显的。但对于绝大多数命令行操作日志处理、文本过滤、编译输出数据量在 MB/s 级别以下tee引入的延迟人类无法感知。优化建议如果写入的是慢速设备如网络存储、USB磁盘可能会成为瓶颈。尽量写入本地SSD或内存盘/tmp。如果只是为了调试可以考虑写入/dev/null或者临时文件事后删除。6.5 如何优雅地停止一个正在使用tee的长时间运行命令场景你运行了long_running_task | tee output.log现在想中途停止。正确操作按下CtrlC。这个中断信号会发送给当前终端的前台进程组也就是long_running_task和tee都会收到。它们会正常终止。注意事项如果你用了tee -i忽略中断那么CtrlC只会终止long_running_tasktee会继续运行并等待输入直到管道关闭。此时你需要用kill命令或开另一个终端找到tee的进程ID来杀掉它。所以除非有特殊需求否则不要轻易使用-i选项。7. 在Shell脚本中的最佳实践将tee集成到自动化脚本中可以极大地提升脚本的可观察性和可维护性。7.1 记录整个脚本的执行轨迹一个好的实践是为脚本设置一个主日志文件记录所有关键操作及其输出。#!/bin/bash # 脚本名deploy.sh set -euo pipefail # 严格的错误处理模式 LOG_FILE“${0%.sh}_$(date %Y%m%d_%H%M%S).log” exec (tee -a “$LOG_FILE”) 21 # exec 命令将当前shell的标准输出和错误都重定向到 tee 进程 # (…) 是进程替换tee 进程会接收所有输出并追加到日志文件同时输出到原终端 echo “ 开始部署 $(date) ” # 接下来所有命令的输出都会既显示又记录 apt update apt install -y my_package systemctl restart my_service echo “ 部署完成 $(date) ”技巧解析exec (command)是一个高级重定向技巧它把当前shell会话后续的所有标准输出都重定向给command。这里command是tee -a “$LOG_FILE”。21把标准错误也合并到标准输出。这样脚本里任何命令的输出都逃不过日志。7.2 分离详细日志和错误日志有时你想把正常的详细输出和错误信息分开记录。#!/bin/bash NORMAL_LOG“normal.log” ERROR_LOG“error.log” # 将标准输出和错误分别重定向到不同的 tee 进程 exec 1 (tee -a “$NORMAL_LOG”) exec 2 (tee -a “$ERROR_LOG” 2) # 注意错误流 tee 的输出仍然重定向回标准错误(2)这样错误信息在终端上还是显示为红色如果终端支持 echo “这是一条普通信息。” echo “这是一条错误信息。” 2文件描述符这里1代表标准输出2代表标准错误。通过分别重定向实现了日志分离。7.3 确保日志写入的完整性配合sync在极端情况下如系统突然崩溃写入磁盘的数据可能还在操作系统缓存里没来得及持久化到物理磁盘。虽然tee调用了写入函数但不能保证数据立刻落盘。 对于关键任务可以在脚本最后强制同步important_job | tee critical.log sync critical.log # 强制将文件数据缓冲写入磁盘或者如果你使用的是 GNU coreutils 的tee并且文件系统支持可以用更高效的方式important_job | tee --output-errorexit critical.log /dev/null sync critical.logsync命令会阻塞直到数据写入磁盘。这会给脚本带来一点延迟但保证了日志的绝对安全。8. 与其他命令的对比与选型命令行中实现类似“分流”效果的不止tee了解它们的区别有助于正确选型。命令/操作核心功能与tee的关键区别适用场景tee从stdin读取写入stdout和文件标准解决方案设计目的就是分流行为可预测支持多文件、追加模式。绝大多数需要同时显示和保存输出的场景管道调试多目的地写入。重定向将stdout重定向到文件覆盖。只写文件不显示在终端。数据流是“单行道”。只需要安静地保存输出不需要实时监控时。重定向将stdout重定向到文件追加。同只写不显示。需要持续追加日志且不需要实时查看时。|管道将stdout连接到下一个命令的stdin。数据传递给下一个命令不保存原始副本。构建数据处理流水线不需要保留中间原始数据时。script记录整个终端会话包括输入。记录的是终端设备的原始字节流包括控制字符、密码输入不安全。功能更底层、更全面。需要完整复现终端交互过程用于审计、教学或调试复杂的交互式程序。tail -f配合重定向实时跟踪文件末尾并输出。它读取文件而tee是写入文件。两者方向相反。监控正在被其他进程写入的日志文件。multitail同时监控多个文件/命令输出。一个高级的监控和查看工具功能丰富颜色、过滤、窗口分割但本身不负责生成或分流数据。需要在一个屏幕里同时观察多个日志源的场景。选型心法要边看边存- 选tee。只要存不要看- 选或。只要传给下个命令不要存- 选|。要记录键盘敲了什么- 选script。要看多个动态日志- 选multitail。最后我个人的体会是tee的魅力在于它的简单和正交性。它只做一件事——分流但把这件事做到了极致并且能完美地嵌入到Unix“小工具大管道”的哲学中。很多复杂的日志、调试需求靠、|和tee这三个核心操作的组合就能优雅解决。下次当你下意识想分两步先运行看结果再运行重定向保存的时候不妨停下来想想是不是一个tee就能让你事半功倍。
)
