Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Wayland/X11

概览

任何操作系统的一个重要组成部分是其显示服务器（display server）。Windows 和 macOS 仅提供一种选项，然而 Linux 却有两种，即 X11 和 Wayland。

X11 是一个较旧的标准，目前大多数 Linux 发行版正逐渐弃用它，转而支持作为其替代品开发的 Wayland。得益于一个名为 Xwayland 的兼容层，即使发行版使用 Wayland，原本运行在 X11 上的应用程序依然可以正常工作。

Godot 对 Wayland 的支持仍在开发完善中，因此目前 X11 依然是游戏项目的默认设置，但这很可能在未来的版本中发生改变。

Wayland 的适用场景

如果你是希望帮助改进支持的引擎开发人员，或者你认为 Xwayland 可能因某些原因导致导出的项目出现视觉瑕疵，那么我们建议你使用 Wayland。但除此之外，目前仍建议坚持使用 X11。需要注意的是，虽然 X11 应用程序可以在 Wayland 上运行，但反过来却不成立。

截至 2026 年 1 月，大多数主流的 Linux 发行版已默认使用 Wayland，包括但不限于以下发行版：

• SteamOS

• Bazzite

• CachyOS

• Fedora

• Fedora Silverblue

• Ubuntu

• OpenSuse

需要注意的是，对于某些发行版（如 Ubuntu），用户可能已经手动将其显示服务器改为了 X11。

更改设置

要将你的显示服务器更改为 Wayland，请单击 Project > project settings，然后转到 Display Server，并将 driver.linuxbsd 选项更改为 wayland。

禁用 Libdecor 的加载

在 Wayland 上加载 Libdecor 存在一些特殊问题，根据你的具体情况，可能需要将其禁用。如需禁用，你需要像下面这样将 GODOT_WAYLAND_DISABLE_LIBDECOR 环境变量设置为 1：

GDScript

OS.set_environment("GODOT_WAYLAND_DISABLE_LIBDECOR", "1")