Linux 命令 `tee` 详解：从基础到高级应用

目录#

1. 基础语法与核心功能
2. 常用选项解析
3. 经典示例：从简单到复杂
4. 高级用法：结合场景的进阶技巧
5. 最佳实践与注意事项
6. 常见问题与解决方案
7. 总结
8. 参考资料

1. 基础语法与核心功能#

1.1 命令语法#

tee 命令的基本格式如下：

tee [选项] [文件1] [文件2] ...

1.2 核心功能#

tee 的名称源自管道（Tee）的形状——它接收标准输入（stdin），并将其“分流”为两路：

• 一路输出到标准输出（stdout，通常是终端）；
• 另一路写入指定的一个或多个文件。

这一特性使得 tee 特别适合“一边看结果，一边存记录”的场景，例如执行命令时同时输出到终端和日志文件。

2. 常用选项解析#

tee 命令的选项较少但实用，不同 Linux 发行版（如 GNU、BSD）可能存在细微差异，建议通过 man tee 或 tee --help 查看系统自带版本的详细说明。以下是最常用的选项：

3. 经典示例：从简单到复杂#

3.1 基础用法：输出到终端并写入单个文件#

场景：执行命令时，希望在终端看到结果，同时保存到文件。

示例：将 echo 输出的内容同时显示在终端和写入 output.txt：

# 基本用法：输出到终端 + 写入文件
echo "Hello, tee!" | tee output.txt

执行结果：

• 终端显示：Hello, tee!
• output.txt 文件内容：Hello, tee!

验证文件内容：

cat output.txt  # 输出：Hello, tee!

3.2 追加模式：避免覆盖文件（-a 选项）#

场景：向已有文件追加内容，而非覆盖。

问题：若直接使用 tee file.txt，会覆盖 file.txt 原有内容。
解决方案：使用 -a 选项追加。

示例：向 output.txt 追加一行新内容：

# 追加模式：不覆盖原文件，仅添加新内容
echo "This is a new line." | tee -a output.txt

验证结果：

cat output.txt
# 输出：
# Hello, tee!
# This is a new line.

3.3 写入多个文件#

场景：同时将输出保存到多个文件（如备份到不同路径）。

示例：将 ls -l 的结果同时写入 list1.txt 和 list2.txt，并显示在终端：

# 写入多个文件：终端 + list1.txt + list2.txt
ls -l | tee list1.txt list2.txt

结果：终端显示目录列表，list1.txt 和 list2.txt 内容完全相同。

3.4 配合 sudo 写入特权文件（解决权限问题）#

场景：向需要管理员权限的文件（如 /etc/hosts、系统配置文件）写入内容。

问题：直接使用 sudo echo "content" > /etc/file 会失败，因为 shell 重定向（>）由当前用户执行，而非 sudo。
解决方案：通过 sudo tee 执行写入，利用 tee 的权限。

示例：向 /etc/hosts 添加一行记录（需管理员权限）：

# 正确姿势：用 sudo tee 写入特权文件
echo "127.0.0.1 mylocaldomain" | sudo tee -a /etc/hosts

原理：echo 输出通过管道传递给 sudo tee，tee 以 root 权限执行，因此可写入 /etc/hosts。

3.5 结合管道与过滤命令#

场景：在复杂管道中，先用 tee 保存中间结果，再继续处理。

示例：查询进程列表，保存完整结果到 processes.log，同时过滤出包含 nginx 的进程：

# 保存完整进程列表到文件，同时过滤 nginx 进程
ps aux | tee processes.log | grep nginx

结果：终端显示 nginx 相关进程，processes.log 保存所有进程信息，便于后续分析。

4. 高级用法：结合场景的进阶技巧#

4.1 在脚本中记录日志与调试（-i 选项）#

场景：编写脚本时，需记录命令输出以便调试，同时忽略用户中断（如 Ctrl+C）导致的日志不完整。

解决方案：使用 -i 选项忽略中断信号，确保日志完整写入。

示例脚本（deploy.sh）：

#!/bin/bash
LOG_FILE="deploy.log"
 
# 记录脚本执行过程，忽略中断信号
echo "=== 开始部署（$(date)）===" | tee -i $LOG_FILE
 
# 执行部署命令，输出同时写入日志
git pull | tee -i -a $LOG_FILE  # -a 追加，-i 忽略中断
npm install | tee -i -a $LOG_FILE
 
echo "=== 部署结束（$(date)）===" | tee -i -a $LOG_FILE

执行脚本：

bash deploy.sh

效果：即使中途按 Ctrl+C，已执行的命令输出仍会完整保存到 deploy.log。

4.2 为输出添加时间戳（结合 ts 工具）#

场景：日志文件中需包含每条记录的时间戳，便于追踪执行顺序。

工具：ts（来自 moreutils 包，需先安装：sudo apt install moreutils 或 sudo yum install moreutils）。

示例：实时监控系统日志（tail -f /var/log/syslog），并将带时间戳的内容保存到 syslog_with_time.log：

# 输出带时间戳的系统日志到终端和文件
tail -f /var/log/syslog | ts '[%Y-%m-%d %H:%M:%S]' | tee syslog_with_time.log

输出示例：

[2023-10-01 14:30:00] Oct  1 14:30:00 localhost kernel: [12345.6789] some kernel message

4.3 保留错误输出（结合 stderr 重定向）#

场景：不仅记录命令的标准输出（stdout），还需记录错误输出（stderr）。

解决方案：通过 2>&1 将 stderr 重定向到 stdout，再通过 tee 统一处理。

示例：执行可能出错的命令（如 ls /nonexistent），将 stdout 和 stderr 同时写入 error.log：

# 同时记录 stdout 和 stderr
ls /nonexistent 2>&1 | tee error.log

结果：终端和 error.log 均显示错误信息：ls: cannot access '/nonexistent': No such file or directory。

5. 最佳实践与注意事项#

5.1 优先使用 -a 避免意外覆盖文件#

风险：未使用 -a 时，tee file.txt 会直接覆盖 file.txt，导致数据丢失。
建议：养成使用 tee -a 的习惯，除非明确需要覆盖文件。

5.2 用 sudo tee 代替 sudo > file 处理权限问题#

错误示例：尝试用 sudo echo "content" > /etc/file 写入特权文件，会因 shell 重定向由当前用户执行而失败。
正确示例：echo "content" | sudo tee /etc/file（tee 以 root 权限执行，可写入特权文件）。

5.3 注意版本差异，优先查阅 man 手册#

不同 Linux 发行版的 tee 可能存在选项差异（如 -p 选项在部分旧版本中不支持）。执行 man tee 或 tee --help 确认系统支持的选项。

5.4 避免不必要的性能损耗#

• tee 支持写入多个文件，但过多文件会增加 I/O 开销，仅在必要时使用。
• 对于超大文件（如 GB 级日志），tee 本身效率较高，但需确保磁盘空间充足。

6. 常见问题与解决方案#

6.1 问题：文件内容为空或不完整#

可能原因：

• 命令未产生输出（如 ls /nonexistent 2>&1 | tee log.txt 忘记重定向 stderr）。
• 中途中断命令且未使用 -i 选项（日志写入被中断）。

解决方案：

• 确认命令是否有输出（可先直接在终端执行命令检查）。
• 对重要日志使用 tee -i 忽略中断。

6.2 问题：tee: file.txt: Permission denied#

原因：当前用户无写入 file.txt 的权限。
解决方案：使用 sudo tee file.txt（需管理员权限）或修改文件权限（chmod）。

6.3 问题：输出在终端和文件中不一致#

可能原因：命令输出包含特殊字符（如颜色控制码），终端能解析但文件中显示乱码。
解决方案：通过 --color=never 禁用命令的颜色输出（如 ls --color=never | tee log.txt）。

7. 总结#

tee 命令虽简单，却是 Linux 管道中的“瑞士军刀”——它连接了标准输入、终端输出和文件写入，为日志记录、实时监控和权限处理提供了高效解决方案。核心要点包括：

• 基础功能：分流输入到终端和文件；
• 关键选项：-a（追加）、-i（忽略中断）、-p（保留输出）；
• 典型场景：命令日志记录、特权文件写入、管道中间结果保存；
• 最佳实践：优先用 -a 避免覆盖，用 sudo tee 处理权限，结合 man tee 确认版本特性。

掌握 tee 命令，能显著提升命令行操作和脚本编写的灵活性，让复杂任务变得简单高效。

8. 参考资料#

• GNU Coreutils: tee 手册
• Linux man 手册：tee(1)
• moreutils 工具集文档（包含 ts 命令）