Linux 窗口环境#

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

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

Hint

当前的 “窗口环境” 列出在 文件 ‣ 关于。

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 不支持设置窗口位置，由于这是设计上的决定，因此不太可能支持该功能（参见窗口位置相关的问题）。