ZeroTermux 内置命令手册详解:time 命令统计 Linux 命令执行时间
ZeroTermux 内置命令手册详解:time 命令统计 Linux 命令执行时间
导读
time 命令是所有类 UNIX 系统(含 Linux、Android 的 Termux 环境)自带的性能测量工具,用于统计给定命令从启动到结束所消耗的总时间,是测试程序性能、比较不同算法优劣时的基础利器。本文以 ZeroTermux 内置命令手册中收录的 time 命令文档为骨架,结合仓库中命令文档的渲染与展示实现(CommandDialog.java),系统讲解 time 命令的语法、real/user/sys 三类时间的含义、shell 内建 time 与 /usr/bin/time 可执行文件的区别,以及 -o、-a、-f 等高级选项和完整格式化参数表,读完即可在 ZeroTermux 终端中独立完成命令耗时分析与结果导出。
一、命令文档在 ZeroTermux 中的展示入口
在深入 time 命令本身之前,先了解本文所依据文档在项目中的位置与作用。ZeroTermux 将数百条 Linux 命令的使用手册以 Markdown 文件形式内置在 app/src/main/assets/cmd 目录下,time.md 即其中之一。用户在 App 内打开命令列表对话框后,即可离线查阅任意命令的语法、参数与实例。
从源码实现看,命令文档的加载与渲染由 CommandDialog.java 完成:
- 通过
AssetManager.list("cmd")枚举cmd目录下的全部命令文档,生成命令列表; - 列表支持实时搜索过滤(
TextWatcher监听输入,按命令名包含匹配并排序); - 点击某个命令后调用
showCmdDetail(),将对应 Markdown 文档通过org.commonmark解析器解析为 HTML,再由 WebView 渲染展示(见 CommandDialog.java); - 对话框整体布局定义在 dialog_command.xml,包含搜索输入框、命令列表 RecyclerView 与 WebView 详情区三层结构。
也就是说,你在 ZeroTermux 中看到的 time 命令手册,就是本文将要展开讲解的这份 time.md 的 HTML 渲染结果,文档中的语法、参数表格与示例全部来自该文件。
二、time 命令的语法与参数
time 命令用于统计给定命令所花费的总时间,其基本语法为:
time(参数)
其中唯一参数 指令 用于指定需要运行的指令及其参数。使用方式上,time 后面直接跟要计时的完整命令行即可,例如:
time ls
time curl https://example.com
time tar -czf backup.tar.gz /data
需要特别说明的是,执行 time 时系统默认调用的是 shell 内建命令,而非独立的可执行文件。由于内建版本功能有限(只支持 real、user、sys 三类时间输出),若需要使用 -o、-a、-f 等扩展功能,必须显式调用 time 命令的可执行二进制文件 /usr/bin/time,这一点将在下文详细展开。
三、输出结果解读:real、user 与 sys 三类时间
执行 time ls 后,终端会输出三行统计数据:
[root@localhost ~]# time ls
anaconda-ks.cfg install.log install.log.syslog satools text
real 0m0.009s
user 0m0.002s
sys 0m0.007s
(示例输出以仓库内 time.md 原文档为准,其中 real 行原文存在一处笔误“这个短时间”,实际应为“这个段时间”,本文引用时修正表述。)
这三行分别代表三种不同的时间度量:
- real 时间(挂钟时间):命令从开始执行到结束所经历的真实墙钟时间。它包含其他进程所占用的时间片,以及当前进程被阻塞(如等待 I/O)时所花费的时间。换句话说,real 是“流逝的物理时间”。
- user 时间(用户模式 CPU 时间):进程花费在用户模式中的 CPU 时间。这是唯一真正用于执行进程自身代码所花费的时间,其他进程的开销以及进程处于阻塞状态的时间都没有计算在内。
- sys 时间(内核模式 CPU 时间):进程花费在内核模式中的 CPU 时间,代表在内核中执行系统调用(如文件读写、内存分配、进程调度相关操作)所花费的时间,这也是真正由该进程使用的 CPU 时间。
一个值得注意的常识:user + sys 通常接近进程自身消耗的 CPU 总量,而 real 可能远大于 user + sys(多进程、多核并行时甚至可能出现 real < user + sys 的情况),通过对比这三类数值即可快速判断程序是 CPU 密集型还是 I/O 密集型。
四、shell 内建 time 与 /usr/bin/time 的区别
文档明确指出:
shell 内建也有一个 time 命令,当运行
time时调用的是系统内建命令;由于内建功能有限,需要其他功能时应使用 time 命令的可执行二进制文件/usr/bin/time。
两者的核心差异体现在:
| 对比项 | shell 内建 time |
/usr/bin/time |
|---|---|---|
| 调用方式 | 直接输入 time cmd |
输入 /usr/bin/time cmd |
| 默认输出 | 仅 real / user / sys 三行 | 可输出额外统计信息 |
-o 输出到文件 |
不支持 | 支持 |
-a 追加写入 |
不支持 | 支持 |
-f 格式化输出 |
不支持 | 支持 |
| 适用场景 | 快速查看三类时间 | 需要格式化、落盘、统计内存/信号等扩展信息的场景 |
因此在 ZeroTermux 终端中做耗时统计时,若只需简单观察,直接使用内建 time 即可;若需要把结果写入文件或定制输出格式,务必使用 /usr/bin/time。
五、常用选项:-o、-a、-f
/usr/bin/time 提供三个最常用的选项,用于控制结果的输出方式与格式。
5.1 -o:将执行时间写入文件
使用 -o 选项可以把计时结果写入指定文件,而不是打印到屏幕:
/usr/bin/time -o outfile.txt ls
执行后,outfile.txt 中保存本次 ls 的耗时统计。该选项适合批量测试脚本,将多轮测试结果依次落盘留存。
5.2 -a:追加写入文件
默认情况下,-o 会覆盖目标文件。若希望保留历史记录,将 -a(append)与 -o 组合使用,即可把每次运行的时间追加到文件末尾:
/usr/bin/time -a -o outfile.txt ls
这一组合是循环压测场景下的标准写法:每一次迭代的耗时都会被追加进同一日志文件,便于后续汇总分析。
5.3 -f:格式化输出
-f(format)选项允许自定义时间输出的内容与格式,例如只输出 user 时间:
/usr/bin/time -f "time: %U" ls
执行后终端仅打印 time: 0.00 之类的定制化结果。-f 后紧跟的字符串中可以混排普通文本与格式化占位符(以 % 开头),实现高度可读的输出。
六、-f 格式化参数完整对照表
-f 选项后的占位符参数及其含义,完整继承自原文档并整理如下:
| 参数 | 描述 |
|---|---|
%E |
real 时间,显示格式为 [小时:]分钟:秒 |
%U |
user 时间 |
%S |
sys 时间 |
%C |
进行计时的命令名称和命令行参数 |
%D |
进程非共享数据区域,以 KB 为单位 |
%x |
命令退出状态(退出码) |
%k |
进程接收到的信号数量 |
%w |
进程被交换出主存的次数 |
%Z |
系统的页面大小,这是一个系统常量,不同系统中常量值也不同 |
%P |
进程所获取的 CPU 时间百分比,这个值等于 user + system 时间除以总共的运行时间 |
%K |
进程的平均总内存使用量(data + stack + text),单位是 KB |
%w |
进程主动进行上下文切换的次数,例如等待 I/O 操作完成 |
%c |
进程被迫进行上下文切换的次数(由于时间片到期) |
(注:原文档表格中 %w 出现两次,分别指“被交换出主存的次数”与“主动上下文切换次数”,表格第一处 %w 与 GNU time 的 -f 语义对应交换次数、第二处对应主动切换次数;不同发行版实现略有差异,实际以系统 man time 为准。)
据此可以拼出高信息量的定制输出,例如同时打印耗时、退出码与 CPU 占用:
/usr/bin/time -f "耗时: %E, 退出码: %x, CPU占用: %P" ls
综合示例:将格式化结果追加写入日志文件:
/usr/bin/time -a -o bench.log -f "%C 耗时:%E user:%U sys:%S CPU:%P" make
该命令在编译项目时把编译命令名、挂钟时间、用户/内核 CPU 时间与 CPU 占用百分比一并追加记录到 bench.log,适合在 ZeroTermux 中做构建耗时统计。
七、实战建议:在 ZeroTermux 终端中评估程序性能
综合前述内容,在 ZeroTermux(Termux 环境)中进行命令级性能评估可遵循以下流程:
- 快速初测:直接使用内建
time查看三类时间,例如time python test.py; - 细化测量:使用
/usr/bin/time -v cmd(-v会输出内存、上下文切换等更详尽的统计)深入分析资源占用; - 结果落盘:用
-o/-a将多轮耗时写入文件,例如for i in $(seq 1 10); do /usr/bin/time -a -o log.txt ./bench; done; - 格式化输出:用
-f定制打印内容,便于脚本解析。
这些能力与 ZeroTermux 内置的其他命令行工具(如 awk.md、top.md 等)配合使用,可以在手机上完成从单条命令耗时统计到系统资源监控的完整性能分析工作流。全部命令手册均可在 App 的命令列表中离线查阅,无需联网。
结语
time 命令虽小,却是理解程序运行性能的第一把钥匙。通过区分 real、user、sys 三类时间,配合 /usr/bin/time 的 -o、-a、-f 选项与格式化参数表,开发者可以在 ZeroTermux 终端中快速定位耗时瓶颈、批量记录测试结果,并输出便于机器解析的统计信息。本文所依托的完整命令手册位于仓库 app/src/main/assets/cmd/time.md,其展示实现可参考 CommandDialog.java 与 dialog_command.xml,读者可直接在 ZeroTermux 应用内打开命令列表体验。