tee的核心价值是“一边显示、一边存盘”，将标准输入复制一份输出到终端、另一份写入文件；常用写法为command | tee output.txt（默认覆盖），加-a参数可追加，支持多文件但全为覆盖模式，不处理stderr需手动重定向。

tee 命令的基本用法：为什么不能直接重定向

直接用 > file 或 >> file 只能保存输出，看不到实时内容；而 tee 的核心价值就是「一边显示、一边存盘」，本质是把标准输入复制一份给标准输出、另一份写入文件。

最常用写法：command | tee output.txt。注意它默认覆盖文件，不是追加。

• 想追加写入？加 -a 参数：command | tee -a output.txt
• 命令本身有错误输出（stderr）？tee 默认不处理，得先重定向：command 2>&1 | tee output.txt
• 不想在终端刷屏，只存文件？用 /dev/null 接收一份：command | tee output.txt >/dev/null

tee 同时写多个文件：别漏掉 -a 的一致性

可以一次写入多个目标：command | tee file1.txt file2.txt。但要注意：所有文件都按「覆盖模式」写入，哪怕其中某个你本想追加。

• 如果要混合模式（比如一个覆盖、一个追加），tee 不支持，得拆成多条管道或用 awk/sed 中转
• 写入多个文件时，任一文件路径不可写（如权限不足、目录不存在），整个 tee 会失败并报错：tee: file2.txt: Permission denied，且后续文件都不再写入
• 常见误操作：以为 tee file1.txt > file2.txt 能同时实现「存 file1 + 覆盖 file2」——实际是把 tee 的 stdout 重定向了，file2 写入的是 tee 的输出（即原 command 的内容），file1 反而没写成

和 shell 重定向嵌套时的坑：顺序和子 shell

tee 是个独立进程，和前后命令不在同一个 shell 环境里，所以变量、cd、alias 都不继承。尤其容易栽在「想把日志和返回值一起捕获」这种场景。

• 下面这行不会按预期工作：result=$(command | tee log.txt) —— $result 是 command 的 stdout，log.txt 也会写入，但如果你还依赖 $? 判断 command 是否成功，它反映的是 tee 的退出码，不是 command 的
• 正确做法：用 PIPESTATUS 数组（bash/zsh）：command | tee log.txt; echo ${PIPESTATUS[0]}
• 想同时捕获 stdout 和 stderr 到文件，又不影响终端显示？必须显式合并：command 2>&1 | tee log.txt，而不是 command 2>log.txt | tee log.txt（后者 stderr 被吞掉，stdout 还重复写）

性能与大文件场景：什么时候不该用 tee

tee 是纯内存缓冲，没有流式分块机制。对超大输出（比如 tar -cf - / | tee backup.tar），它会吃光 buffer，甚至触发 OOM killer。

• 替代方案：用 pv（带进度）或直接双写：command > file1.txt && command > file2.txt（适合 command 很快、可重复执行的场景）
• 需要加密或压缩保存？别链式套太多：command | gzip | tee backup.gz 比 command | tee >(gzip > backup.gz) 更稳，后者依赖 bash 进程替换，某些旧系统不支持
• 在脚本中长期运行的任务（如 tail -f 日志），用 tee 会持续占用 fd，记得配合 timeout 或信号捕获做清理

真正麻烦的不是语法，是搞清你要捕获的是什么流、谁该负责退出状态、以及磁盘满或中断时文件是否半截——这些在自动化脚本里最容易被忽略。