GNOME/故障排除
Shell 冻结
如果 Shell 冻结（可能由某些外观调整、故障的扩展程序或内存不足引起），按 Alt+F2 然后输入 r 重启 Shell 可能无效。
在这种情况下，尝试切换到另一个 TTY (Ctrl+Alt+F2) 并输入以下命令：pkill -HUP gnome-shell。Shell 可能需要几秒钟才能成功重启。在 X11 上，通过这种方式重启 Shell 不会注销用户，但最好还是确保保存了所有工作；在 Wayland（当前为默认）上，重启 Shell 会杀死整个会话，因此所有内容都将丢失。
如果失败，需要重启 Xorg 服务器，对于控制台登录，可以使用 pkill X；对于 GDM 登录，可以 重启 gdm.service。请注意，重启 Xorg 服务器将注销用户，因此请尝试在尝试此操作之前确保所有工作都已保存。
应用程序默认设置不正确
首次安装应用程序时，您可能会发现 GNOME 将不正确的应用程序与特定协议关联，例如，将 easytag 设为文件夹处理程序，而不是 GNOME Files。
有关 GNOME Files，请参阅以下页面：GNOME Files#Files 不再是默认文件管理器。
要查询当前关联的应用程序以及 PDF 的推荐应用程序，请运行
$ xdg-mime query default application/pdf
要将 PDF 的默认应用程序更改为 Document Viewer，请运行以下命令
$ xdg-mime default org.gnome.Evince.desktop application/pdf
对于其他应用程序，默认处理程序的设置详见以下页面：默认应用程序。
可选地，您可以 安装 gnome-defaults-listAUR。它会将您的配置文件放在 /usr/share/applications/gnome-mimeapps.list。
还有另一个 MIME 类型关联命令。如果使用 xdg-mime query default <mime-type> 查询到的当前关联应用程序已正确，但仍有错误的应用程序处理该类型，请尝试此操作
- 通过运行：
gio mime application/pdf来检查gio关联 - 如有必要，使用
gio mime application/pdf org.gnome.Evince.desktop将关联更改为 Document Viewer
搜索不列出任何本地文件
为了让 Gnome 的 localsearch 工具索引您的本地文件，它们必须存储在 符合 XDG 的目录中（例如“Documents”或“Music”）。有关更多信息，请参阅 XDG 用户目录。
您还可以配置 localsearch 以递归搜索特定目录。这些目录可以通过“设置”>“搜索”>“搜索位置”指定。
GNOME 在线账户设置页面显示不正常
在某些情况下，由于与 Alacarte（菜单编辑器）的交互，GNOME 在线账户设置页面将不会显示。如果发生这种情况，“在 Alacarte 中恢复系统配置”可以恢复 gnome-control-center 的缺失功能。（参见 https://bugzilla.redhat.com/show_bug.cgi?id=1520431。）
登录时 GNOME 在线账户弹出窗口为空白
某些服务需要身份验证才能登录（如 Google、Microsoft 等），因此在某些情况下（如 Nvidia 驱动程序）弹出窗口将为空白而不是重定向到登录页面。要解决此问题，请暂时禁用 WebKit Composite。
$ WEBKIT_DISABLE_COMPOSITING_MODE=1 gnome-control-center online-accounts
无法在 dconf-editor 中更改设置
当无法在 dconf 中设置时，可能是 dconf 用户设置已损坏。在这种情况下，最好删除 ~/.config/dconf/user* 中的 dconf 用户文件，然后再次在 dconf-editor 中设置。
当扩展程序导致 Shell 损坏时
当启用 Shell 扩展程序导致 GNOME 损坏时，您应该首先从其安装目录中删除 user-theme 和 auto-move-windows 扩展程序。
安装目录可能是 ~/.local/share/gnome‑shell/extensions、/usr/share/gnome‑shell/extensions 或 /usr/local/share/gnome‑shell/extensions 之一。删除这两个包含扩展程序的文件夹可能会修复损坏。否则，通过试错法隔离问题扩展程序。
从上述目录中删除或添加一个包含扩展程序的文件夹，即可在系统中删除或添加相应的扩展程序。有关 GNOME Shell 扩展程序的详细信息，请访问 GNOME 网站。
如果您在通过 extensions.gnome.org/local 卸载扩展程序时遇到问题，那么它们可能已作为系统范围的扩展程序通过 gnome-shell-extensions 包安装。再次删除该包显然会影响所有用户帐户。
GNOME 3 更新后扩展程序无法工作
在尝试以下解决方法之前，请访问 extensions.gnome.org/local 查看是否有扩展程序的更新。
如果还没有适用于您当前 GNOME 版本的更新，请使用以下命令禁用扩展程序的版本验证
$ gsettings set org.gnome.shell disable-extension-version-validation true
或者，您可以修改扩展程序本身，更改支持的 Shell 版本以满足版本验证。请参阅下面的方法。
找到您安装扩展程序的文件夹。它可能是 ~/.local/share/gnome-shell/extensions 或 /usr/share/gnome-shell/extensions。
编辑每个扩展子文件夹中出现的 metadata.json。
| Insert | "shell-version": ["3.x"]
|
| 而不是（例如） | "shell-version": ["3.4"]
|
"3.x" 表示该扩展程序适用于所有 Shell 版本。如果它损坏了，您就会知道需要将其改回。
仅运行 conky 时键盘快捷键不起作用
GNOME Shell 键盘快捷键，如 Alt+F2、Alt+F1 以及媒体键快捷键，在仅运行 conky 时不起作用。但是，如果同时运行了 gedit 等其他应用程序，则键盘快捷键会起作用。
解决方案：编辑 .conkyrc
own_window yes own_window_transparent yes own_window_argb_visual yes own_window_type dock own_window_class Conky own_window_hints undecorated,below,sticky,skip_taskbar,skip_pager
无法应用存储的显示器配置
如果您遇到此消息，请尝试禁用 xrandr gnome-settings-daemon 插件
$ dconf write /org/gnome/settings-daemon/plugins/xrandr/active false
一致的光标主题
请参阅 光标主题#桌面环境。
无法通过 Alt 键 + 鼠标按钮修改窗口
在 GNOME 3.6 及更高版本中，鼠标按钮修饰键（允许您从标题栏以外的位置拖动窗口的按键）是 Super 键，而不是过去使用的 Alt 键。此更改是为了响应以下 错误报告。
要将鼠标按钮修饰键改回 Alt 键，请执行以下操作
$ gsettings set org.gnome.desktop.wm.preferences mouse-button-modifier '<Alt>'
系统图标加载缓慢/GDM 登录缓慢
标题栏图标（如 Files 的图标）加载缓慢的问题可以通过执行以下命令来解决
# gdk-pixbuf-query-loaders --update-cache
运行上述命令还可能解决“哦不！出了点问题！”错误屏幕的重复出现和/或 GDM 的非常缓慢的加载和登录问题，详见以下 论坛帖子。
最大化窗口时出现伪影
从 GNOME 3.12.0 开始，最大化窗口可能会出现伪影 - 请参阅以下 论坛帖子和 错误报告。以下部分详细介绍了解决方案：#Intel HD Graphics 的无撕裂视频。
Intel HD Graphics 的无撕裂视频
- DRI3
根据 错误报告，DRI3 包含 buffer_age 扩展，该扩展允许 GNOME Shell 的 Mutter 合成器以高效的方式将窗口同步到 vblank。自版本 1:2.99.917+682+g4eaab17-1 起，DRI3 在 xf86-video-intel 中默认启用 [1]。
- Intel TearFree
启用 Xorg Intel TearFree 选项是 Intel 适配器上撕裂问题的已知解决方法。但是，此选项的激活方式会增加内存消耗并降低性能，请参阅 原始错误报告的最终评论。
- Mutter 调整
GNOME Shell 的 Mutter 合成器有一个已知可以解决撕裂问题的调整（请参阅 此修复的原始建议及其在 Freedesktop 错误报告中的提及）。要启用此调整，请将以下行添加到 /etc/environment：CLUTTER_PAINT=disable-clipped-redraws:disable-culling。然后重启 Xorg 服务器。
- 禁用全屏取消重定向
GNOME Shell 默认会取消重定向全屏应用程序。这可能导致撕裂。您可以使用 GNOME Shell 扩展程序 gnome-shell-extension-disable-unredirectAUR 来禁用此功能。
使用多显示器时窗口出现在其他窗口后面
这可能是 GNOME Shell 中的一个错误，导致新窗口出现在其他窗口后面。要解决此问题，可以运行以下命令
$ gsettings set org.gnome.shell.overrides workspaces-only-on-primary false
锁定按钮无法重新启用触摸板
某些笔记本电脑有一个触摸板锁定按钮，可以禁用触摸板，以便用户在打字时不必担心触摸到触摸板。目前看来，虽然 GNOME 可以通过按下此按钮锁定触摸板，但无法解锁它。如果触摸板被锁定，您可以运行以下命令来解锁它
$ xinput set-prop "SynPS/2 Synaptics TouchPad" "Device Enabled" 1
GNOME Shell 键盘源菜单不可见
一个显示键盘输入源（例如，英文键盘布局的“en”）的菜单应该会显示在包含网络、音量和电源图标的状态区域旁边。如果键盘源菜单不可见，这很可能是因为您以 GNOME 未识别的方式配置了 Xorg 键盘布局。
为确保菜单可见，请删除您可能创建的任何 Xorg 键盘配置，并使用 localectl 设置键盘区域设置。
运行该命令并注销后，您应该会发现在 GDM 和 GNOME Shell 桌面中键盘输入源菜单可见。有关更多信息，请参阅 GNOME 中的输入源。
鼠标光标丢失
当使用独立的 窗口管理器与 gnome-settings-daemon 一起使用时，鼠标光标可能会消失。运行
$ gsettings set org.gnome.settings-daemon.plugins.cursor active false
屏幕锁定时会话菜单中没有重启按钮
如果安装了 XScreenSaver，请确保它没有在启动时运行，请参阅 GNOME#自启动。
PulseAudio 系统范围内的配置导致 GNOME 和 GDM 延迟
如果您正在使用系统范围模式下的 PulseAudio，PulseAudio 7.0 升级会破坏 GDM 和 GNOME。有关更多信息，请参阅 此论坛帖子。
尝试在 GNOME Shell Dash 中重新排序应用程序时 GNOME 崩溃
dash 是“工具栏”，默认情况下，当您单击“活动”时会出现在 左侧。可以通过拖放来重新排序 dash 中的应用程序。如果失败，并且/或导致 GNOME 崩溃，请尝试 更改您的图标主题。
GNOME 视频播放器 (Totem) 中没有 H264 视频
请参阅 编解码器和容器#Totem 播放器中没有 H264、mpg4 或 Musepack (.mpc)。
合上盖子时没有挂起
GNOME 默认情况下具有关于挂起的此行为
- 未连接外部显示器，合上盖子时计算机挂起。
- 已连接外部显示器，合上盖子时计算机不挂起。
目前，gnome-tweaks 无法修改第二种情况下的行为（当连接了显示器时）。虽然它可以阻止在未连接显示器时挂起。
gnome-shell / gnome-session 在会话启动时崩溃
有时 gnome-session 在登录后立即崩溃。这在 wayland 上可能更明显，并且可能看起来像是每第二次登录尝试都失败。可以通过删除 ~/.config/gnome-session/saved-session 中的文件来临时解决此问题。更持久的解决方法是禁用会话管理器 `auto-save-session` 功能
$ gsettings set org.gnome.SessionManager auto-save-session false
低 OpenGL 性能和卡顿
- 使用专有 NVIDIA 驱动程序
这个错误很可能是原因。您应该在 mutter 中回滚 383ba566bd7c2a76d0856015a66e47caedef06b6 提交。为此使用 ABS，并在 PKGBUILD 的 prepare() 函数中添加 git revert -n 383ba566bd7c2a76d0856015a66e47caedef06b6，或者直接安装 mutter-performanceAUR。
- 使用开源驱动程序
如果视频播放卡顿（略有），请尝试使用 GNOME on Xorg 而不是 Wayland。
GNOME Wayland 会话不可用
GNOME Wayland 尚不支持一个以上的 GPU 输出，将回退到 GNOME X11。
如果您的显示器仅连接到其中一个视频设备，请将此添加到您的 系统环境变量中
MUTTER_ALLOW_HYBRID_GPUS=1
另请参阅 GDM#Wayland 和专有 NVIDIA 驱动程序。
gnome-control-center 为空且不列出任何类别
在替代窗口管理器（例如 i3）下，gnome-control-center 会以空窗口的形式启动。您需要将变量 XDG_CURRENT_DESKTOP 设置为 GNOME 才能启动它（可以在脚本中设置，或在 ~/.profile 中导出该变量）。
export XDG_CURRENT_DESKTOP=GNOME gnome-control-center &
使用功能键 (Fn) 快捷键后 GNOME 会冻结一秒
这是巴西葡萄牙语 ABNT 2 键盘的问题。如果您启用了巴西葡萄牙语，GNOME 可能会遇到此问题。要解决此问题并继续使用此键盘布局，请通过注释掉 /usr/share/X11/xkb/symbols/br 中的以下行来取消映射滚动锁定按钮
modifier_map Mod3 { Scroll_Lock };
然后重新启动会话（注销并重新登录）。
缩放键盘快捷键在某些应用程序上不起作用
Ctrl+加号和Ctrl+减号的缩放键盘快捷键在某些 GNOME 应用程序（如 Files 和 GNOME Terminal）上默认不起作用。
在这种情况下，打开 GNOME Tweaks（gnome-tweaks），然后导航到“键盘和鼠标”>“其他布局选项”按钮>“数字键盘布局”。将 Disabled 值更改为 Hexadecimal。
打印机配置在 GNOME 设置中不起作用
应安装 CUPS 和 system-config-printer
屏幕阅读器不起作用
GNOME Software 不显示 Arch Linux 包
packagekit 集成已被自愿禁用，并被认为不受支持；另请参阅 archlinux/packaging/packages/gnome-software#4。
触摸板上的右键单击不起作用
在按钮分离的触摸板上（例如，无按钮触摸板），用一根手指在触摸板的右侧 - 或任何其他位置 - 点击，可能会产生左键单击的效果，而您期望的是右键单击。
从 GNOME 3.28 开始，触摸板的默认行为是双指轻触模拟鼠标右键。此行为可以在 GNOME Tweaks（gnome-tweaks）中通过转到左侧菜单的键盘和鼠标，然后选择鼠标点击模拟选项来更改。
单击方法可用的值如下
- 手指
- 默认值，双指轻触模拟右键单击（默认）
- 区域
- 轻触按钮-右键单击可实现右键单击行为，轻触按钮-中间可实现中间单击
- 禁用
- 无鼠标单击模拟
或者，此行为可以通过命令行界面使用 gsettings 进行更改。例如，要设置区域单击方法
$ gsettings set org.gnome.desktop.peripherals.touchpad click-method areas
设备安全设置面板行为异常
请参阅 GNOME#设备安全设置。
Wayland 上的光标大小或主题问题
某些 Qt 应用程序（如 Telegram）可能未设置光标设置[2][3]。这可能导致光标主题、大小不正确，并且无法调整窗口大小。
手动设置 XCURSOR_THEME 和 XCURSOR_SIZE 环境变量（例如，XCURSOR_THEME=Adwaita、XCURSOR_PATH=/usr/share/icons 或 XCURSOR_SIZE=24）。
您还可以使用内联获取当前系统的光标大小
$ XCURSOR_SIZE="$(gsettings get org.gnome.desktop.interface cursor-size)" _executable
如果上述变量在 Wayland 上不起作用（例如在 Telegram 中），请尝试另外添加 QT_QPA_PLATFORM=xcb
强制 GNOME 软件渲染
如果您遇到 GPU 驱动程序问题，可以使用以下 环境变量强制 GNOME 会话进行软件渲染
对于 Wayland 会话
MESA_LOADER_DRIVER_OVERRIDE=kms_swrast
对于 X11 会话
LIBGL_ALWAYS_SOFTWARE=1