Sway 光标主题完整指南：5 步换指针，动画与排错一次讲清

Sway 光标主题完整指南：5 步换指针，动画与排错一次讲清

【免费下载链接】swayi3-compatible Wayland compositor项目地址: https://gitcode.com/GitHub_Trending/swa/sway

刚装好 Sway，光标是系统默认箭头，很难起眼。这份指南以 Sway 光标主题设置为例，带你把从安装主题到验证的流程走一遍，再讲清 XWayland 兼容、光标动画与不生效时的快速自查。

Sway 光标由谁说了算

这一节说清一件事：光标最终长什么样，由谁拍板。Sway 的光标渲染由三样东西共同决定。XCURSOR_THEME与XCURSOR_SIZE是环境变量，也就是系统级的「变量」，任何程序询问「我该怎么画光标」时默认读它们。配置文件里的seat可以理解为一套键鼠加显示器的组合，xcursor_theme指令让每个座位各用一套主题。swaymsg是向运行中的 Sway 发送命令的命令行工具，不用动文件就能当场改动。三者有层次：环境变量打底，seat0 的主题在配置文件中覆盖打底值，并被自动导出给 XWayland，swaymsg 做运行时临时修改，立刻生效但不落盘。这三层就是 Wayland 光标配置的全部。指令的权威说明见sway-input(5) 手册。

三种配法怎么选

同一套 Sway 自定义鼠标指针，有三种配法，不知道选哪种的话，先看下面这张表的差异：

# 不动配置文件，立刻改一次光标 swaymsg seat seat0 xcursor_theme Papirus 28

5 步完成第一次换光标

下面 5 步走完，你的第一套 Sway 光标主题就算装好了，全程十分钟内。

1. 装主题包。以常用的 Papirus 为例：

# 安装光标主题（Debian/Ubuntu 示例） sudo apt install papirus-cursors # 查看主题目录名，配置里就用这个名字 ls /usr/share/icons

2. 记住名字。主题名就是上一步列出的目录名，比如Papirus，区分大小写。
3. 在配置文件里写一行：

# 追加到 ~/.config/sway/config seat seat0 xcursor_theme Papirus 24

4. 重载。执行swaymsg reload，光标当场变化，不用退出会话。
5. 验证。没变化就跳到文末「主题不生效？三步自查」；不满意就回到第 1 步换一个主题包再来。

让 XWayland 程序跟上

X11 老程序不会自己读 Wayland 侧的光标设置，这一节说明它们为什么会掉队，以及怎么办。

好消息是：配置文件中 seat0 的主题会被自动导出为XCURSOR_THEME与XCURSOR_SIZE变量，交给 XWayland 使用。所以多数情况下，Sway XWayland 光标兼容不需要你做任何事。若想让某个特定应用单独用另一套指针，启动时覆盖变量即可：

# 让某个 X11 应用单独使用一套光标 env XCURSOR_THEME=Oxygen XCURSOR_SIZE=24 steam

还有一处细节：游戏常用「指针锁定」把光标捕获进窗口，画面里多半是游戏自己画的准星，系统主题对它影响不大，别在这上面纠结。

动画光标与自动隐藏

这一节给光标加两个可选增强：Sway 光标动画与闲置自动隐藏。

动画看主题本身：主题 cursors 目录里带anim_前缀的文件就是动画帧，装上即生效，没有额外开关。自动隐藏由hide_cursor指令提供两种模式：

# 鼠标 5 秒不动就隐藏；打字时隐藏光标 seat seat0 hide_cursor 5000 seat seat0 hide_cursor when-typing enable

超时单位是毫秒，写 0 表示关闭，100 是下限。⚠️when-typing模式可能干扰游戏、以及需要键鼠同时操作的软件（如 GIMP、Blender），开启前想清楚。

💡 低配机器降级思路：动画卡顿就换成 Oxygen、DMZ 这类静态主题，尺寸降到 20，并关掉when-typing，指针会明显更跟手。

一套系统多套光标：多座位

两人共用一台机器、或者做无值守展示时，把设备拆成多个座位，各自拥有独立的键鼠、焦点和光标。

# 两个人用不同的光标，键鼠各管各的 seat player xcursor_theme Papirus 24 seat player attach "1234:567:G_Pro_X" seat guest xcursor_theme DMZ-White 28 seat guest fallback true

attach把指定设备固定到某个座位，设备编号用swaymsg -t get_inputs查。标了fallback true的座位会自动接管所有没被明确分配的设备，可以当成「兜底座位」。如果你什么都没写，Sway 默认使用名为seat0的座位。

主题怎么选

主题不少，这一节给按气质与场景的选择口径：

拿不准就先装 Papirus 或 Adwaita，翻车概率最低。

主题不生效？三步自查

换完主题光标没变时，按「查座位、查变量、找目录」三步走：

1. 查座位：配置里写的座位名可能不是你实际在用的那个，多座位下尤其容易写错。
2. 查环境变量：X11 程序只认XCURSOR_THEME与XCURSOR_SIZE，某个应用还是旧样式，多半是它读的是变量。
3. 找光标目录：主题名拼错，或目录不在搜索路径里，Sway 都会回落到默认光标。

# 看各座位当前用的主题 swaymsg -t get_seats # 看当前 shell 的环境变量 echo $XCURSOR_THEME $XCURSOR_SIZE # 找光标主题装在哪 find /usr/share/icons ~/.icons -maxdepth 2 -type d -name cursors

名字确认无误仍不生效时，可暂时把座位名换成*通配符试试，这是官方手册给出的排查建议。

设置不必一次到位，换一套用一周，不合适再换。

命令备忘

• swaymsg reload：重新加载配置
• swaymsg seat seat0 xcursor_theme <主题> <尺寸>：立即更换光标
• swaymsg -t get_seats：查看各座位当前主题

【免费下载链接】swayi3-compatible Wayland compositor项目地址: https://gitcode.com/GitHub_Trending/swa/sway