tldr 仓库中的 uptime 命令速查页解析：系统运行时长检查的实用指南
tldr 仓库中的 uptime 命令速查页解析：系统运行时长检查的实用指南
uptime 是 GNU coreutils 提供的一个经典系统诊断命令，用于查询系统从启动至今的运行时长、当前时间、登录用户数量与系统负载等关键信息。本篇文章以 tldr 仓库中 pages.ar/common/uptime.md 这份阿拉伯语速查页为主体，结合仓库内英文、中文等多语言版本与 阿拉伯语风格指南，系统讲解 uptime 的典型用法、选项语法、平台差异以及 tldr 页面规范，帮助读者快速掌握该命令并理解 tldr 文档的组织方式。
uptime 是什么：一条命令看到系统状态全貌
uptime 命令在首次执行时会向终端打印一行信息，通常包含四个核心要素：
- 当前系统时间；
- 系统已运行时长（从本次启动算起）；
- 当前已登录的用户数量；
- 系统在最近 1、5、15 分钟的平均负载（load average）。
在 tldr 的阿拉伯语页面 pages.ar/common/uptime.md 中，命令描述被翻译为「يعرض مدة تشغيل النظام ومعلومات أخرى」，即「显示系统运行时长及其他信息」，并在"更多信息"一行指向 GNU coreutils 手册中的 uptime 章节。
由于 uptime 在 Linux 与 macOS 上行为一致、无平台差异，它被归入 common（通用）目录而非 linux 或 osx 目录。这意味着各平台的 tldr 客户端都会默认展示这条通用页面，而不是某个平台专属的版本。
直接运行：一次调用获取完整状态
速查页的第一个示例是所有用法中最基础的一条，不带任何选项直接运行：
uptime
对应阿拉伯语描述为「طباعة الوقت الحالي، ومدة التشغيل، وعدد المستخدمين المسجلين، ومعلومات أخرى」，即打印当前时间、运行时长、已登录用户数及其他信息。典型输出如下：
10:28:17 up 3 days, 2:15, 1 user, load average: 0.08, 0.02, 0.01
从左到右依次可以读出：当前时间、已运行天数与小时数、在线用户数、以及 1/5/15 分钟平均负载。对于服务器运维排查"这台机器多久没重启了"这类问题，这一条命令往往就是全部答案。
常见选项详解
tldr 速查页围绕 uptime 的三个高频选项组织了三个示例，全部采用了 {{[-短选项|--长选项]}} 的可选占位符语法，允许不同偏好（习惯短选项或长选项）的用户直接复制使用。这一语法约定在 阿拉伯语风格指南 中有明确规定：为了客户端能够在长、短选项之间切换展示，应使用 {{[-o|--output]}} 形式的选项占位符。
-p / --pretty：只看运行时长
uptime {{[-p|--pretty]}}
描述为「عرض مدة التشغيل فقط منذ بدء تشغيل النظام」，即仅显示系统自启动以来的运行时长。输出采用人类易读的格式，例如：
up 3 days, 2 hours, 15 minutes
该选项适合在脚本中提取"已运行时间"字段，或用在监控面板上展示简洁的时长信息。
-s / --since：查看系统启动时刻
uptime {{[-s|--since]}}
描述为「طباعة تاريخ ووقت بدء تشغيل النظام」，即打印系统的启动日期与时间。输出示例：
2026-09-29 08:13:02
配合 -p 使用可以同时获知"何时启动"与"已运行多久"，比单独换算日期更为直观。
-V / --version：查看工具版本
uptime {{[-V|--version]}}
描述为「عرض إصدار الأداة」，即显示工具版本信息，用于确认当前环境下的 coreutils 版本，排查因版本差异导致的选项行为变化。
需要说明的是，按 阿拉伯语风格指南 的约定，tldr 页面通常把帮助与版本类命令放在页面末尾的两个示例位置，本页将 -V/--version 作为最后一个示例正是遵循这一排版规范。
英文原版中的补充选项：-r / --raw
对比仓库内英文原版 pages/common/uptime.md 可以发现，英文页面比阿拉伯语版本多出一个 -r / --raw 选项示例：
uptime {{[-r|--raw]}}
其含义是「以秒为单位显示时间数据」（Display the time data in seconds），适合需要机器可读输出的脚本场景。阿拉伯语页面未收录该示例，这与 tldr 各语言页面允许按翻译进度与篇幅灵活取舍的组织方式一致——多语言翻译并不强制逐条对齐，但都源自同一份英文母版。
平台差异：为什么还有独立的 macOS 页面
虽然 uptime 被归入 common 通用目录，但仓库中同时存在 pages/osx/uptime.md。对比两个文件可以看到，macOS 版本仅保留了最基础的 uptime 示例，描述同样是"告知系统已运行多久及其他信息"，但"更多信息"链接指向的是 macOS 的 man 页面（xcode-man-pages），而非 GNU coreutils 手册。
这一双页面并存的模式在 阿拉伯语风格指南 的「平台差异」小节中有明确解释：当命令在不同操作系统上存在差异时，tldr 客户端会优先展示用户当前平台对应的页面；例如 Windows 用户看到 pages.ar/windows/ 下的版本，而 Linux 与 macOS 用户默认看到 pages.ar/common/ 下的通用版本。uptime 的情况则略有不同——它被认定为通用命令，osx 下的独立页面用于承载 macOS 特有的文档来源链接。
阿拉伯语页面的翻译与占位符约定
本页属于阿拉伯语（ar）翻译页面，其翻译遵循仓库的阿拉伯语风格指南。有几个值得注意的约定：
- 占位符不翻译：页面中的
{{<a href="https://link.gitcode.com/i/0a1f3777cb7024b715ffb65ff6640f5c" target="_blank">-p|--pretty]}}等占位符保持英文原文。这在 [common-arguments.md 中有专门说明——阿拉伯语（ar）和波斯语（fa）页面中的占位符不应翻译，以避免 RTL（从右到左）文本渲染时出现翻转混乱； - 描述使用命令式语气：所有示例描述都采用祈使句（如"打印""显示""查看"），对应 阿拉伯语风格指南 中"所有描述必须以命令式语气书写"的规则；
- 最多 8 个示例：单条命令页面不超过 8 个示例，
uptime页的 4 个示例保持了精简实用的风格。
页面规范与质量保障
uptime 页面遵循 tldr 统一页面模板，结构为：# 命令名 → > 一句话描述 → > 更多信息链接 → 若干「- 描述 + 反引号命令」对。仓库通过 check-errors.sh 脚本对全量页面做自动化检查，包括占位符格式（如 {{-[a-zA-Z][a-zA-Z]|- 短长选项配对写法）、反引号是否成对、描述中是否混入占位符、版本信息行 #> 的误用等；同时 阿拉伯语风格指南 建议使用 tldr-lint 对页面进行本地校验：
npm install --global tldr-lint
tldr-lint path/to/tldr_page.md
也就是说，像 uptime 这样的速查页并不是随手写的笔记，而是经过模板约束、lint 工具校验和跨语言同步管理的结构化文档。
实践建议：快速上手 uptime
综合本仓库文档信息，给出以下实操建议：
- 日常查看：直接输入
uptime，一次性获得时间、运行时长、用户数与负载； - 脚本判断重启时间：用
uptime {{[-s|--since]}}拿到启动时刻，或用uptime {{[-r|--raw]}}获得秒级时长（参考英文原版 pages/common/uptime.md）； - 人读展示：用
uptime {{[-p|--pretty]}}输出"up 3 days, 2 hours"这类友好格式； - 排查版本问题：用
uptime {{[-V|--version]}}确认 coreutils 版本； - 在 macOS 上：注意独立页面 pages/osx/uptime.md 的文档来源为 macOS man 手册，基础行为与 GNU 版一致。
tldr 的精髓在于"一页速查"：每条命令用最少的示例覆盖最高频的用法。uptime 页面正是这一理念的缩影——四个示例就完整覆盖了状态总览、时长、启动时间与版本四大场景，配合可切换的短长选项语法，让不同习惯的开发者都能直接复制使用。