Linux time 命令:测量耗时、CPU 时间与 GNU 资源统计
time 用于测量命令或管道的实际耗时和 CPU 使用时间。Bash 的 time 是保留字,可以直接测量内建命令、函数和整个管道;外部 GNU /usr/bin/time 还能报告内存、输入输出等资源统计。
只想快速了解执行时间,可先用 Bash time;需要最大内存、缺页等详细指标时,应明确调用外部 GNU Time。两者同名,但选项和格式变量并不通用。
先确认使用的是哪一种 time
Bash 会先把未引用、位于相应语法位置的 time 识别为保留字,而不是普通程序名。这使它能对整个管道、函数和内建命令计时。很多 Linux 系统还安装了独立的 GNU Time,先检查当前环境:
type -a time
command -V time
ls -l /usr/bin/time
type -a time 和 command -V time 可帮助识别名称;ls 则检查示例路径是否存在。若 /usr/bin/time 不存在,需先安装发行版的 GNU Time 软件包或确认实际路径。下文的 Shell 示例以普通 Bash 模式为准;Bash 的 POSIX 模式下,后一个词以 - 开头时,time 不会被当作保留字识别。
Bash 语法和 TIMEFORMAT 可查阅 Bash bash(1) 原文手册的 man7 镜像;其他命令可参考 Linux 常用命令分类速查。
Bash time 的基本语法
下面是语法示意,方括号及占位名称需要按实际任务替换:
time [-p] command [arguments...]
time [-p] command1 | command2
在要测量的命令前加上 time:
time sleep 1
time find /usr -type f >/dev/null
sleep 1 通常会显示接近 1 秒的 real,而 CPU 时间很少;调度与系统负载可能使实际耗时更长。第二条命令遍历 /usr,将文件列表丢弃,只保留计时和可能的错误信息;目录规模和权限会影响结果,不应把它视为固定基准。
real、user、sys 分别表示什么?
| 指标 | 含义 |
|---|---|
real |
从开始到结束的实际经过时间,包含磁盘、网络以及等待调度等耗时。 |
user |
所测任务在用户态消耗的累计 CPU 时间。 |
sys |
内核为所测任务执行系统操作消耗的累计 CPU 时间。 |
多线程或多个进程在不同核心上并行运行时,累计的 user + sys 可以大于 real。如果主要在等待输入输出,real 可能很大而 CPU 时间很小。CPU 时间不等于总等待时间,也不表示程序一直占满一个核心。
测量整个管道的耗时
Bash 保留字 time 会等待后面的整个前台管道结束,再输出统计:
time find /var/log -type f -print0 | xargs -0 wc -l >/dev/null
这个示例查找日志目录中的文件,再用 wc -l 统计行数;空字符分隔可处理文件名里的空格。读取日志需要相应权限,压缩或二进制文件的换行数也不代表实际日志记录数,因此它只演示计时范围。
若把 /usr/bin/time 放在管道首个程序前,通常只测量它启动的程序。需要用外部工具测量整个管道时,应显式启动包含该管道的 Shell;此时 Shell 启动开销也属于范围。先明确所测任务的起止边界,才能比较结果。
把多个命令作为一个任务测量
用花括号或圆括号可以将一组命令整体计时。以下构建示例要求已有正确的项目、Makefile 和构建脚本;请先确认项目目录以及 make clean 会删除哪些构建产物,不要在未知项目中直接运行。
time {
make clean &&
make -j4
}
time (
cd /srv/app &&
./build.sh
)
花括号组在当前 Shell 中执行,目录和变量的修改会影响当前会话;圆括号组在子 Shell 中执行,结束后不会保留这些修改。这里用 && 确保清理成功才编译、切换目录成功才执行构建,避免失败后继续在错误位置运行命令。
使用 -p 获得可移植的时间格式
time -p sleep 1
-p 按 POSIX 风格输出 real、user、sys 三行,以秒为单位。需要脚本解析时,还应固定合适的数字区域设置,例如在启动测量 Shell 时使用 LC_ALL=C,并考虑精度差异。上面的写法适用于普通 Bash 模式;其他 Shell 或 Bash POSIX 模式应先确认解析到的实现。
使用 TIMEFORMAT 自定义 Bash 输出
Bash 保留字通过 TIMEFORMAT 设置报告格式:
TIMEFORMAT='elapsed=%3R s user=%3U s sys=%3S s'
time sleep 1
%3R 中的 3 表示显示三位小数,并不保证测量本身具有毫秒级准确度。
| 格式 | 含义 |
|---|---|
%R |
经过时间,单位为秒。 |
%U |
用户态 CPU 时间,单位为秒。 |
%S |
内核态 CPU 时间,单位为秒。 |
%P |
CPU 百分比,按 (user + sys) / real 计算。 |
%% |
字面百分号。 |
赋值会影响当前 Shell 后续的计时输出。临时使用时,可保留并恢复原值,或在子 Shell 里设置。下面的完整示例在子 Shell 中设置格式:
下面提供完整的测试任务:在当前目录中创建新的 time-demo 目录及可执行的 job.sh。如果该目录已存在,示例会停止并提示换用新目录;成功后,当前 Shell 留在测试目录,后续示例都在这里运行。
if mkdir time-demo && cd time-demo; then
cat >job.sh <<'EOF'
#!/usr/bin/env bash
printf '%s\n' '任务开始'
sleep 1
printf '%s\n' '任务结束' >&2
EOF
chmod u+x job.sh && (
TIMEFORMAT='elapsed=%R s'
time ./job.sh
)
else
printf '%s\n' '请使用新的测试目录,并确认可以进入该目录。' >&2
false
fi
示例向标准输出写入“任务开始”,等待约一秒,再向标准错误写入“任务结束”。子 Shell 结束后,外层 TIMEFORMAT 不变。练习后可以保留测试目录核对报告,或在文件管理器中仅删除自己创建的目录。若 TIMEFORMAT 被设为空字符串,Bash 会不显示计时报告;GNU Time 使用的是另一套 -f 格式或 TIME 环境变量,不读取 Bash 的 TIMEFORMAT。
明确调用外部 GNU Time
确认 GNU Time 已安装后,用完整路径避开 Bash 保留字,并使用前面创建的任务:
/usr/bin/time ./job.sh
/usr/bin/time -v ./job.sh
-v 报告可获得的详细统计,包括最大常驻内存、缺页次数、文件系统输入输出和上下文切换。系统未提供的统计可能显示为零,零不一定证明资源完全没有使用;输入输出计数也不应直接当成字节数。
GNU Time 的选项、格式和限制可在 GNU 官方 Time 发布目录的当前源码包内 doc/time.texi 或 doc/time.info 查阅。这里使用的基本选项也适用于常见旧版本,实际支持情况应结合本机 /usr/bin/time --version 和手册确认。
GNU Time 常用选项
| 选项 | 作用 |
|---|---|
-p |
使用 POSIX 风格的时间格式。 |
-v |
逐项显示可获得的资源使用统计。 |
-f 格式 |
通过格式指定符选择需要的统计。 |
-o 文件 |
将报告写入指定文件,默认覆盖旧内容。 |
-a |
与 -o 一起使用,将报告追加到文件末尾。 |
只输出耗时和最大常驻内存
/usr/bin/time -f 'elapsed=%e max_rss=%MKB' ./job.sh
GNU 格式中的 %e 是以秒表示的经过时间,%M 是任务生命周期内的最大常驻集大小,GNU 手册标为 Kilobytes。它是峰值指标,不是执行前后相减得到的内存增量,也不是所有并行进程峰值的简单总和。
将计时报告保存到文件
/usr/bin/time -v -o time-report.txt ./job.sh
/usr/bin/time -v -a -o time-report.txt ./job.sh
第一条写入或覆盖 time-report.txt,第二条再追加一次报告。测量任务自己的标准错误仍按原有方式输出,便于与计时报告分开。保存重要报告前,注意 -o 的覆盖行为。
为什么时间报告默认写入标准错误?
这样能避免时间报告混入测量任务的标准输出,尤其是标准输出要进入管道或文件时:
time ./job.sh >job-output.txt
这只将任务的标准输出保存为 job-output.txt;任务自己的标准错误和 Bash 计时报告仍写入原来的标准错误,通常是终端。要重定向 Bash 计时报告,需要把计时语句放进组,再处理整个组的标准错误:
{ time ./job.sh >job-output.txt; } 2>time-and-errors.txt
此时 time-and-errors.txt 同时包含任务自己的错误输出和时间报告,并不是纯计时数据。使用示例脚本时,“任务开始”进入 job-output.txt,“任务结束”和时间统计进入 time-and-errors.txt。只想单独保存资源报告时,GNU Time 的 -o 更清晰。
怎样进行可靠的速度比较?
- 首次与后续运行可能因文件系统缓存、即时编译(JIT)和连接复用而不同,应明确比较的是冷启动还是预热后的执行。
- 尽量控制后台负载、CPU 频率调整和虚拟机资源竞争,保持输入、并发数及软件版本一致。
- 极短任务容易受启动和计时开销影响,不要根据一次很小的差异判断优劣。
- 重复测量多次,比较中位数和分布,同时检查异常值产生的条件。
- 输出到终端、文件或空设备会改变工作量,比较时应保持相同的输出方式。
- 同时检查退出状态、结果内容和错误信息,避免把失败退出误认为性能提升。
Bash time 与外部 GNU Time 对比
| 比较项 | Bash time | GNU /usr/bin/time |
|---|---|---|
| 类型 | Bash 保留字。 | 独立可执行程序。 |
| 整个管道 | 可直接对后续前台管道计时。 | 默认测量所启动的程序;整体管道需要显式启动 Shell。 |
| 函数和内建命令 | 可直接测量。 | 需通过适当的 Shell 执行;新 Shell 不自动拥有当前会话全部函数。 |
| 详细资源统计 | 主要提供时间统计。 | -v 可报告内存、输入输出等系统指标。 |
| 自定义报告 | TIMEFORMAT。 |
-f、-o、-a。 |
常见问答
user 时间可以大于 real 吗?
可以。多线程或多个进程在不同 CPU 核心上同时运行时,累计用户态 CPU 时间可能超过实际经过时间。应结合任务并行度和 sys 一起判断。
为什么 time -v 不能使用?
普通 Bash 模式中的 time 保留字不接受 GNU Time 的 -v 选项。确认已安装 GNU Time 后,使用 /usr/bin/time -v 命令,并检查路径和本机实现。
time 会改变被测命令的退出状态吗?
正常运行时返回所测命令或管道的状态;Bash 管道默认取最后一个命令的状态,启用 pipefail 后则按其规则返回失败状态。GNU Time 找不到程序通常返回 127、无法执行返回 126,计时工具自身出错也可能返回非零,因此不能只因出现时间报告就认定任务成功。




