linux-command 速查手册：xlsatoms 命令详解——列出 X 服务器内部所有原子成分

• 文档
• 教程

xlsatoms是 X Window System 提供的一个命令行诊断工具，用于列出 X 服务器内部所有已定义的原子（Atom）成分及其编号。本文基于 linux-command 仓库中的 command/xlsatoms.md 文档展开，系统讲解原子的概念、xlsatoms的语法与全部选项，并结合仓库索引与同类 X 工具，帮助你快速掌握排查 X 服务器内部状态的方法。

什么是 X 原子（Atom）

在 X Window System 中，原子（Atom）是服务器端维护的一个全局命名表：客户端（如窗口管理器、GTK/Qt 应用）为了在进程之间传递属性名、类型名等元数据，会先将字符串"登记"为原子并取得唯一的整数编号，之后双方通过编号而不是字符串进行通信。

xlsatoms所列出的一切，正是这张原子表中的条目：每个原子成分都有自身的编号，命令通过-range限定编号区间，或通过-name精确匹配名称，实现"全量浏览"与"定点查询"两种排查方式。这一功能在调试窗口管理器协议（如WM_PROTOCOLS、_NET_WM_NAME）以及检查服务器状态时非常实用。

命令语法

xlsatoms(选项)

该命令不带任何必选参数，直接执行即可列出服务器当前定义的全部原子；需要缩小范围时再叠加选项。在 linux-command 的索引文件 dist/data.json 中，xlsatoms条目被登记为：

"xlsatoms": { "n": "xlsatoms", "p": "/xlsatoms", "d": "列出X服务器内部所有定义的原子成分" }

同时在 README.md 中被归类于"电子邮件与新闻组"下的 X Windows System 工具组（与xlsclients、xlsfonts等并列），可见其定位是 X 图形环境下的标准诊断命令。

选项详解

linux-command 文档共收录了 4 个选项，含义如下：

各选项的典型用法

查看完整原子列表（默认行为）

xlsatoms

输出形如：

0 (no name) 1 PRIMARY 2 SECONDARY ...

每行第一个数字即原子编号，第二个为原子名称；尚未命名（未登记）的编号显示为(no name)。

只查询指定名称的原子

xlsatoms -name WM_PROTOCOLS

适合在调试窗口管理器协议时，确认某个协议原子是否已被服务器登记。

按编号区间过滤

xlsatoms -range 0-100

只显示编号0到100之间的原子，可在原子数量庞大时快速缩小排查范围。

指定目标显示器

xlsatoms -display :1

当存在多个 X Server（如多用户会话、Xvfb 虚拟显示器）时，用从0递增的显示器编号锁定目标。

自定义输出格式

xlsatoms -format '%d|%s\n'

以竖线分隔编号与名称，方便awk、cut等文本工具进一步处理，也便于嵌入监控或巡检脚本。

与其它 X 诊断工具的分工

xlsatoms只是 X 环境排查工具链中的一环。仓库中还收录了定位相近的姊妹命令，可组合使用：

• xlsclients：列出当前显示器中的客户端应用程序（即哪些程序连接了 X Server）；
• xlsfonts：列出 X Server 使用的字体清单，支持范本样式过滤；
• xauth：显示和编辑连接 X 服务器所需的认证信息。

三者分别回答"服务器内部定义了哪些原子""谁在连服务器""服务器加载了哪些字体"这三个不同维度的问题，配合使用可以快速摸清 X 环境的整体运行状态。在 dist/data.json 中，这几个命令的索引条目彼此相邻，读者可按需在仓库中逐个查阅。

注意事项

• xlsatoms需要能连接到目标 X Server，通常要求本地已登录图形会话；通过-display指定远程显示器时，还需具备相应的 X 访问权限（可借助xhost或xauth配置）。
• 原子编号由服务器在运行时动态分配，不同会话、不同服务器的编号并不一致，因此排查时应以"名称"为稳定参照，编号仅作浏览与过滤用途。
• 本文所有命令选项均以 command/xlsatoms.md 收录内容为准，具体行为可能随 X.Org 实现版本略有差异，可在实际环境中以man xlsatoms核验。

• 文档
• 教程