故障排查与诊断 (Troubleshooting)

2026年8月13日更新于 2026年8月14日

系统在更新后出现故障！

首先尝试将系统回滚到更新前自动生成的系统快照。如果无法解决，可运行 omarchy-debug 生成诊断报告并在 Discord 社区的 #omarchy-help 频道反馈交流。如果所有尝试均告失败，可通过终端运行 omarchy-reinstall 重新安装所有默认配置与核心软件包。

为什么部分应用在屏幕上显示尺寸过大？

Omarchy 默认假定使用 2x 视网膜高分屏，因此在 ~/.config/hypr/monitors.lua 中将 GDK_SCALE 设为了 2。如果你使用的是 1x 标准分辨率屏幕，只需将 local omarchy_gdk_scale = 2 改为 1（随后重启尺寸过大的应用程序）。详见显示器与屏幕缩放。

针对 Spotify，你可以使用 Ctrl + - 缩小界面（使用 Ctrl + + 放大界面）。

为什么 Caps Lock 大写锁定键不起作用？

在 Omarchy 中，Caps Lock 键被默认指派为了 XCompose 组合前缀键。这也是输入快捷 Emoji 和文本补全的核心方式。如果你确实习惯使用传统的大写锁定功能，可以通过编辑 ~/.config/hypr/input.lua 将 XCompose 键重映射到其他按键，例如右侧 Alt 键：

hl.config({
  input = {
    kb_options = "compose:ralt",
  },
})

我的 Wi-Fi、蓝牙、音频或触控板突然失效了

在重启电脑之前，先尝试单独重启出问题的子系统。Omarchy 菜单中的 Update > Hardware 提供了 Wi-Fi、Bluetooth、Audio 以及 Trackpad 的独立重载功能，能够快速解决绝大多数“几分钟前还好好的”突发状况 —— 例如蓝牙耳机无法重连、从睡眠唤醒后触控板无响应、拔掉外接显示器后声音消失等。

为什么外接音箱没有声音输出？

通常是因为外接音箱未被设为主音频输出设备。点击状态栏右侧的喇叭图标打开音量面板，在其中即可切换音频输出设备（还支持针对单个应用分别调节音量）。

笔记本内置扬声器听起来发闷或失真

在部分笔记本上，Omarchy 会自动加载扬声器校准配置以修正内置扬声器的频响曲线。运行 omarchy audio tuning status 可查看当前机器是否启用了校准，若你更喜欢原汁原味的原始声音，运行 omarchy audio tuning off 即可关闭。

为什么密码输入正确却无法登录或执行 sudo？

你可能由于连续输错密码次数过多被 PAM 安全策略临时锁定了账户。如果发生在锁屏界面，可以按下 Ctrl + Alt + F2 进入纯文本 TTY 终端，以 root 身份登录后执行 faillock --reset --user [your-username] 解除锁定，之后即可正常使用。

为什么 1Password SSH Agent / CLI 的授权弹窗没有弹出？

通常有以下两种可能原因：

为了显示丰富的图形授权弹窗，必须在 1Password 设置中开启 Settings > Advanced > Use Hardware Acceleration（使用硬件加速）。注意：该设置需要重启系统方可生效。

troubleshooting-1password

或者，如果自本次开机以来你从未主动启动过 1Password 主程序，该授权弹窗也将无法弹出。

来源

Omarchy Manual: Troubleshooting官方