Shell脚本-tee工具

一、前言

在 Linux/Unix 系统中，tee 是一个非常实用的命令行工具，它可以帮助我们 同时将命令的输出打印到终端，并写入文件。这种"双路输出"机制在脚本调试、日志记录、自动化任务中非常有用。

无论是做日志分析、脚本调试，还是编写部署脚本，tee 都是一个不可或缺的工具。

本文将带你全面了解 tee 工具的使用方式，包括：

✅ tee 的基本语法与常用参数

✅ 如何将命令输出既显示又保存

✅ tee 在 Shell 脚本中的实战应用

✅ 与其他文本处理命令的联合使用

✅ 实际开发中的常见问题与优化建议

并通过完整的代码示例帮助你快速上手并熟练掌握 tee 的各种高级用法。

二、什么是 tee？

tee 是一个用于 复制输入流到多个输出 的命令行工具。它可以将标准输入的内容输出到标准输出（通常是终端），同时写入一个或多个文件。

✅ 典型用途包括：

场景	示例
日志记录	将脚本执行过程保存到日志文件
调试输出	查看命令结果的同时保存到文件
自动化部署	输出安装进度并记录到日志
权限操作	使用 sudo + tee 写入受保护文件

三、tee 基础语法

command | tee [选项] 文件名

✅ 常用选项说明：

参数	描述
-a 或 --append	追加写入文件，而不是覆盖
-i 或 --ignore-interrupts	忽略中断信号（如 Ctrl+C）
-p	如果管道写入失败，不退出程序（默认会退出）
--help	显示帮助信息
--version	显示版本信息

四、tee 使用示例

✅ 示例1：基础使用 ------ 同时输出到终端和文件

echo "Hello, World!" | tee output.txt

终端输出：

Hello, World!

同时 output.txt 文件中也写入了该内容。

✅ 示例2：追加写入（-a）

echo "Line 1" > output.txt
echo "Line 2" | tee -a output.txt

此时 output.txt 内容为：

Line 1
Line 2

✅ 示例3：同时写入多个文件

echo "Data to log" | tee file1.log file2.log

file1.log 和 file2.log 都会被写入 "Data to log"。

✅ 示例4：忽略中断信号（-i）

ping www.baidu.com | tee -i ping.log

即使按下 Ctrl+C，tee 也不会立即终止，而是继续写入最后一段数据。

五、tee 在 Shell 脚本中的应用

✅ 示例1：记录脚本运行日志

#!/bin/bash
exec > >(tee -a script.log) 2>&1
echo "脚本开始执行..."
sleep 2
echo "正在处理任务..."
echo "脚本执行完成。"

此脚本的所有输出都会显示在终端，并写入 script.log 文件。

✅ 示例2：权限提升后写入文件（结合 sudo）

echo "new content" | sudo tee /etc/myconfig.conf

即使 /etc/myconfig.conf 没有写权限，也可以通过 sudo tee 成功写入。

✅ 示例3：调试脚本时查看中间结果

ls -la /var/log/ | tee debug_output.txt | grep error

你可以看到中间的 ls 结果，同时也能进行后续 grep 过滤。

六、tee 与其他命令的配合使用

✅ 示例1：结合 grep 过滤并记录日志

dmesg | grep "error" | tee error_log.txt

输出所有错误信息到终端，并保存到 error_log.txt。

✅ 示例2：结合 awk 提取字段并保存

ps aux | awk '{print $1, $2}' | tee process_info.txt

提取进程用户和 PID 并保存。

✅ 示例3：结合 curl 下载并显示进度

curl -s https://example.com/data.json | tee data.json | jq .

下载 JSON 文件并实时显示其内容（通过 jq 解析）。

七、tee 使用技巧总结

技巧	说明
✅ 使用 -a 追加写入	避免覆盖已有日志
✅ 多文件写入	可以一次写入多个目标文件
✅ 结合 exec 记录整个脚本输出	适用于调试和审计
✅ 与 sudo 配合写入只读文件	替代 echo > /path/to/file 的权限问题
✅ 忽略中断信号（-i）	防止意外中断导致数据丢失
✅ 结合 pipe 管道链式调用	实现复杂数据流处理

八、tee 实战案例汇总

✅ 案例1：记录编译日志

make all 2>&1 | tee build.log

编译过程中实时查看输出，并保存完整日志。

✅ 案例2：自动备份配置文件并修改

cat /etc/ssh/sshd_config | tee sshd_config.bak | sed 's/PasswordAuthentication no/PasswordAuthentication yes/' | sudo tee /etc/ssh/sshd_config

先备份原配置，再修改并写回。

✅ 案例3：监控网络请求并记录响应

curl -s http://api.example.com/status | tee response.log | jq .

查看 API 返回值并保存原始数据。

九、常见问题与解决方法

问题	原因	解决方案
文件未被写入	权限不足	使用 sudo tee
内容被覆盖而非追加	未使用 -a	添加 -a 参数
输出乱码或编码异常	编码不一致	设置 LANG=C 或使用 iconv 转换
tee 退出太快	被中断信号终止	使用 -i 忽略中断
输出顺序混乱	多线程或异步输出	使用 script 或重定向统一处理

十、总结对比表：tee 常用参数一览

参数	功能
-a	追加写入文件
-i	忽略中断信号
-p	出错时不退出
--help	显示帮助信息
--version	显示版本信息

十一、结语

感谢您的阅读！如果你有任何疑问或想要分享的经验，请在评论区留言交流！