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 文件。
对于 GNOME 文件，请参阅以下页面：GNOME Files#文件不再是默认文件管理器。
要查询当前关联的应用程序和推荐的 pdf 应用程序，请运行
$ xdg-mime query default application/pdf
要将 pdf 的默认应用程序更改为文档查看器，请运行以下命令
$ 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更改关联到文档查看器
搜索不列出任何本地文件
为了让 Gnome 的本地搜索工具索引您的本地文件，它们必须存储在 XDG 兼容目录（例如“文档”或“音乐”）中。 有关更多信息，请参阅 XDG 用户目录。
您还可以配置本地搜索以递归搜索特定目录。 这些可以通过设置 > 搜索 > 搜索位置指定。
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。
| 插入 | "shell-version": ["3.x"]
|
| 而不是（例如） | "shell-version": ["3.4"]
|
"3.x" 表示扩展程序适用于每个 shell 版本。 如果它崩溃，您就会知道将其改回。
仅在 conky 运行时键盘快捷键不起作用
如果 conky 是唯一运行的程序，则 GNOME shell 键盘快捷键（如 Alt+F2、Alt+F1 和媒体键快捷键）不起作用。 但是，如果另一个应用程序（如 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 登录缓慢
系统图标加载问题（例如文件标题栏中的图标）可以通过执行以下命令解决
# gdk-pixbuf-query-loaders --update-cache
运行上述命令还可以修复重复出现的“糟糕！出了点问题！”错误屏幕和/或 GDM 加载和登录非常缓慢的问题，如以下 论坛帖子 中所述。
最大化窗口时出现伪影
从 GNOME 3.12.0 开始，最大化窗口可能会导致伪影 - 请参阅以下 论坛帖子 和 错误报告。 解决方案在以下部分详细说明：#Intel 核芯显卡无撕裂视频。
Intel 核芯显卡无撕裂视频
- DRI3
根据 错误报告，DRI3 包括 buffer_age 扩展，该扩展允许 GNOME Shell 的 Mutter 合成器以有效的方式将窗口同步到垂直同步。 从版本 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
显示键盘输入源的菜单（例如，英语键盘布局为“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 Player 中没有 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 执行此操作，并将 git revert -n 383ba566bd7c2a76d0856015a66e47caedef06b6 添加到 PKGBUILD 中的 prepare() 函数，或者直接安装 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 中的此行来取消映射 Scroll Lock 按钮
modifier_map Mod3 { Scroll_Lock };
然后重启会话（注销并重新登录）。
缩放/缩小键盘快捷键在某些应用程序上不起作用
Ctrl+加号 和 Ctrl+减号 键盘快捷键用于缩放/缩小功能在某些 GNOME 应用程序（例如文件和 GNOME 终端）上无法开箱即用。
在这种情况下，打开 GNOME Tweaks (gnome-tweaks) 并导航到“键盘和鼠标”>“附加布局选项”按钮 >“数字键盘布局”。 将“已禁用”值更改为“十六进制”。
打印机配置在 GNOME 设置中不起作用
应安装 CUPS 和 system-config-printer
屏幕阅读器不起作用
安装 espeak-ng。 或者，可以使用 festival
GNOME 软件商店不显示 Arch Linux 软件包
packagekit 集成已 自愿禁用 并且 被认为不受支持。
触摸板右键单击不起作用
在按钮分开的触摸板（例如无按钮触摸板）中，用一根手指点击触摸板的右侧 - 或任何其他位置 - 可能会给您左键的行为，而预期的是右键。
从 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