- 文档
- 教程
- 知识库
【免费下载链接】tldr
Collaborative cheatsheets for console commands 📚.
dumpsys是 Android 平台内置的系统服务诊断工具，用于一次性导出设备上所有（或指定）系统服务的内部状态与运行数据。本文以 tldr 开源仓库中的 孟加拉语 dumpsys 速查页 为骨架，结合其英文原版页与仓库规范，完整解析该命令的 6 种核心用法、参数语义与实战场景。读完本文，你将能够通过adb shell熟练采集系统服务快照、按服务名定向查询、跳过无关服务，并为耗时诊断设置安全超时。
一、dumpsys 是什么：Android 系统服务的"体检报告"
dumpsys是一条运行于 Android 设备上的系统工具命令，其职责正如速查页开头所描述：收集 Android 系统服务相关的信息（原文：অ্যান্ড্রয়েড সিস্টেম সার্ভিসগুলো সম্পর্কে তথ্য সংগ্রহ করুন）。在 tldr 仓库中，该命令被归类在android平台目录下，仓库同时维护了三种语言版本：
- pages.bn/android/dumpsys.md（孟加拉语，本文主体）
- pages/android/dumpsys.md（英文）
- pages.en/android/dumpsys.md（英文独立目录版本）
Android 系统在运行时由大量后台服务（system services）组成，例如负责窗口管理的 WindowManager、负责网络策略的 NetworkPolicyManager、负责电量统计的 Batterystats 等。当开发或排障人员需要了解某个服务的实时状态、内部配置或统计计数时，dumpsys就是最直接的入口——它把这些服务"自述"的文本快照一次性倾倒到标准输出，供工程师筛选分析。
二、使用前提：只能在adb shell中调用
速查页在说明部分明确标注了一条关键限制：
该命令只能通过
adb shell使用。（原文：এই কমান্ডটি শুধুমাত্রadb shellএর মাধ্যমে ব্যবহার করা যাবে）
这意味着dumpsys不能像普通 App 一样直接执行，它运行在系统框架的 shell 上下文中。典型的调用链路是：先用adb连接设备并进入交互式 shell，再在其中执行dumpsys：
adb shell dumpsys也可以在非交互模式下通过单条命令直接执行：
adb shell dumpsys在 tldr 仓库的 Android 目录中，还有多条命令同样遵循"只能通过adb shell使用"的约定，例如 bugreport 页面 与 wm 页面，它们共同构成了基于 adb 的设备调试命令族。
三、六个核心命令用法完整速查
速查页一共给出 6 条命令示例，覆盖了dumpsys从"全量导出"到"定向过滤"再到"超时保护"的完整使用谱系。下面逐条继承并展开讲解。
1. 收集所有系统服务的诊断输出
dumpsys不带任何参数直接执行dumpsys，会把设备上全部系统服务的诊断输出依次打印出来。由于现代 Android 设备服务数量庞大，这段输出通常有数千行乃至更多，一般用于"先整体看一眼"，随后配合下述定向命令缩小范围。
2. 收集指定系统服务的诊断输出
dumpsys {{সার্ভিস}}{{সার্ভিস}}是 tldr 的占位符语法（Bengali 中意为"服务"），实际使用时替换为具体的服务名。例如，若想只查看窗口管理器的状态：
dumpsys window这是dumpsys最高频的用法——只输出目标服务的诊断文本，输出量小、可读性强，适合日常巡检和问题定位。
3. 列出所有可查询的服务
dumpsys -l-l选项让dumpsys只输出它能够提供信息的所有服务名单（即服务名列表），而不是海量的诊断正文。这一条是第 2 条用法的"前置侦察"：先dumpsys -l拿到准确的服务名拼写，再dumpsys {{服务名}}定向查询，避免因服务名写错而报错。
4. 查看指定服务的参数列表
dumpsys {{সার্ভিস}} -h在服务名之后追加-h，可以列出该服务特有的帮助信息与可用参数。它展示的是dumpsys支持传递给该服务的附加子参数——不同服务支持不同的附加参数，例如某些服务允许通过附加参数限定输出范围或切换详细级别。先-h查看能力，再按需传参，是深入使用某个服务诊断功能的正确姿势。
5. 从诊断输出中排除指定服务
dumpsys --skip {{সার্ভিস}}--skip选项用于在执行全量dumpsys时跳过某个指定的服务，将其从输出中剔除。当只需要"除了某个服务之外"的全量快照（例如已知某服务输出过长或有干扰）时，这一条非常实用。
6. 设置超时时间（默认 10 秒）
dumpsys -t {{8}}-t用于以秒为单位指定超时周期，速查页明确标注默认值为10 秒。上例将超时设为 8 秒。在设备负载较高或服务响应缓慢时，过长的诊断过程会拖住 shell，显式收紧超时可以避免命令长时间挂起；反之在服务状态复杂、需要更完整数据时，也可以调大该值。
小结：这 6 条命令覆盖了
dumpsys的完整使用闭环——全量导出（dumpsys）、定向查询（dumpsys {{服务}}）、名单侦察（-l）、能力探查（-h）、排除干扰（--skip）与超时保护（-t）。
四、速查页的规范化设计：tldr 内容标准在其中的体现
dumpsys页面不是随意写就的，它严格遵循了仓库的 内容风格指南。理解这些规范，有助于读懂页面的每个细节：
- 页面模板固定：标题行用
#一级标题写明命令名；说明行以>开头，前两条分别给出功能描述与使用限制；随后是"描述 + 代码块"交替的示例区。 - 示例数量上限：风格指南规定每页至多 8 条命令示例，
dumpsys页恰好编排了 6 条，结构紧凑不臃肿。 - 占位符语法：用户需要自行替换的值统一用
{{...}}包裹（如{{সার্ভিস}}），便于各 tldr 客户端高亮显示、引导用户填空。 - 祈使句描述：每条示例描述均使用祈使语气（"收集…""列出…""排除…""设定…"），直接告诉用户该做什么，这也是全仓库所有语言页面的默认要求。
- 多语言同步：孟加拉语页与英文页在示例结构上完全一一对应，说明部分只翻译描述、不翻译命令本身与参数符号。这种"内容同构、语言替换"的维护方式，是 tldr 多语言体系能够保持各语种同步的关键。
如果你想在本地校验这类页面的格式是否合规，风格指南还给出了两个工具：通过npm install --global tldr-lint安装 linter 后运行tldr-lint 页面路径检查，或用tldr --render 页面路径在本地渲染预览。
五、与其它 Android 调试命令的协同定位
在 tldr 仓库的 孟加拉语 Android 目录 中，dumpsys并不是孤立存在的，它与若干同类命令共同组成了设备调试工具链，可从仓库页面中直接对照学习：
| 命令 | 职责 | 仓库页面 |
|---|---|---|
dumpsys | 导出系统服务内部状态与诊断文本 | dumpsys.md |
bugreport | 生成并查看完整的 Bug 报告 | bugreport.md |
logcat | 倾倒系统日志（含错误堆栈与 App 消息） | logcat.md |
settings | 读写系统配置项（global/system/secure 命名空间） | settings.md |
wm | 查看屏幕物理尺寸与像素密度 | wm.md |
实际排障时，它们通常是配合使用的：先bugreport收集整体现场，用logcat追踪错误日志，再用dumpsys定向导出嫌疑服务的状态，最后通过settings调整系统配置做验证。dumpsys在这一链条中扮演"服务内部状态快照"的角色，其输出往往能直接暴露服务崩溃、配置异常或资源占用等问题的根源。
六、实战建议与适用边界
从仓库证据可以总结出以下使用要点，帮助你在真实设备上安全、高效地使用dumpsys：
- 先
-l后查询：服务名拼写错误是新手最常见的报错来源，dumpsys -l能给出权威名单。 - 全量导出要节制：裸执行
dumpsys输出量极大，优先使用dumpsys {{服务名}}定向查询；需要全量快照时用--skip剔除无关服务。 - 善用超时保护：默认超时为 10 秒，面对慢服务时可通过
-t调整；在自动化脚本中显式设置较小超时，可防止脚本被长时间卡死。 - 区分信息层次：
dumpsys提供的是系统服务内部诊断状态，与logcat的日志流、bugreport的整体报告属于不同信息源，定位问题时应各取所长。
需要说明的是，本文所有命令行为均以 tldr 仓库当前维护的速查页为准；不同 Android 版本（如不同 API 级别）对个别服务的内部输出格式可能存在差异，实际使用时建议以设备上dumpsys -l与dumpsys {{服务}} -h的实际返回为准。
- 文档
- 教程
- 知识库
【免费下载链接】tldr
Collaborative cheatsheets for console commands 📚.
相关推荐
linux-command 命令手册：sosreport 系统诊断信息收集工具详解
linux command 命令手册：sosreport 系统诊断信息收集工具详解 sosreport 是 Red Hat Enterprise Linux 系
文档教程pixi info 命令全解析：读懂系统、工作区与环境诊断信息
pixi info 命令全解析：读懂系统、工作区与环境诊断信息 pixi info 是 pixi 内置的诊断命令，一条命令即可输出当前机器（平台、虚拟包、缓存、
开发工具CLI包管理器任务调度Gel `instance status` 命令完全指南：查看实例信息、状态与诊断
Gel instance status 命令完全指南：查看实例信息、状态与诊断 gel instance status 是 Gel CLI 中用于查看实例信息的
数据库图数据库关系型数据库
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
