Linux 窗口环境

在 Linux 上，Blender 的正式版本同时支持 X11 和 Wayland．

当检测到 Wayland 时，它是首选的系统，否则将使用 X11．

Hint

当前的窗口环境在 顶栏 ‣ Blender ‣ 关于 Blender 中列出。

X11

这是历来在 Linux 和 Unix 系统上使用最广泛的窗口环境。

近期没有计划废弃或移除 X11 支持。

Wayland

对 Wayland 的支持是最近添加的，因此可能存在尚未测试的配置。如果遇到问题，请报告错误。

Blender 已针对基于 Gnome-Shell（mutter）、KDE（plasma）和 SWAY（wlroots）的合成器进行了测试。

要求

Gnome-Shell

在 Gnome-Shell 环境下，需要使用 libdecor 库。该库在大多数 Linux 发行版中均可作为软件包获取。

如果找不到该库，将使用 X11 作为后备。

问题排查

详细的 Wayland 输出有助于追踪问题。通过命令行使用附加参数启动 Blender：

Blender 的 Wayland 日志记录

blender --log "ghost.wl.*" --log-level 2

Wayland 内置日志记录

WAYLAND_DEBUG=1 blender

禁用 Wayland（强制 X11）

WAYLAND_DISPLAY="" blender

禁用 libdecor（在 Gnome-Shell 下强制使用无边框窗口）

卸载 libdecor，然后在 X11 显示变量为空的情况下运行 Blender．

DISPLAY="" blender

环境变量

XCURSOR_THEME

要使用的光标主题（必须引用本地已安装的光标）。

XCURSOR_SIZE

光标大小默认为 28，您可能希望在高 DPI 显示器上增大尺寸。

已知局限

Gnome Shell 的分数缩放（44 版之前）

Gnome-Shell 44 之前的版本并不完全支持分数缩放。

在较旧版本的 Gnome-Shell 中使用分数可能会导致一些故障，例如光标尺寸过小。

NVIDIA GPU

目前，NVIDIA 驱动程序并不完全支持 Wayland 所需的功能。图形故障和闪烁是常见问题。在某些情况下，可能会出现启动时崩溃。这并非 Blender 独有的问题，因此 NVIDIA 用户可能希望使用 X11，直到驱动程序支持得到改善。

---

特性比较

特性	X11	Wayland	注意
平滑滚动	✗	✓	使用触控板实现流畅滚动。
多点触控手势	✗	✓	支持触控板和平板电脑上的 多指缩放、平移和环绕操作。
可靠且平滑的光标重新定位	✗ *1	✓	例如，在对视口进行变换和环绕操作时， 会使用光标变形效果。
窗口定位	✓	✗ *2	用于在窗口之间拖动以及 在加载文件时恢复窗口位置。

两套系统均支持的其他功能，例如高 DPI、3D 鼠标、数位板输入等，均未列入此列表。

^*1 在 X11 中，当光标被捕获（例如进行变换）时，快速移动光标可能会使其超出窗口边界。

^*2 Wayland 不支持设置窗口位置，由于这是设计上的决定，因此不太可能支持该功能（参见窗口位置相关的问题）。