故障排查
本文译自 The Omarchy Manual — Troubleshooting,同步自 basecamp/omarchy@ed7bae4。术语以 TERMS.md 为准。
更新把我的系统搞坏了!
先尝试回滚系统到最近更新之前的版本。不行的话,用 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 + Minus 缩小 UI(Ctrl + Plus 放大)。
为什么 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、蓝牙、音频和触控板,「五分钟前还好好的」的大多数情况——蓝牙耳机连不上、挂起后触控板失灵、拔掉显示器后声音消失——重载对应一项就能解决。
为什么外接音箱不出声?
多半因为它没被设为主输出。点顶栏右侧的扬声器图标打开音量弹窗,在那里选输出设备(还能按应用单独调音量)。
笔记本喇叭听起来不对劲
在某些笔记本上,Omarchy 会自动应用扬声器调音来校正内置扬声器的频响。omarchy audio tuning status 查看你的机器是否启用;想听「生肉原声」就 omarchy audio tuning off 关掉。
为什么密码登不上或 sudo 失败?
大概率是输错次数太多被锁了。锁屏上发生的话,CTRL + ALT + F2 开一个新 TTY 以 root 登录,然后运行 faillock --reset --user [your-username] 重置锁定即可。
为什么 1Password SSH Agent / CLI 的授权弹窗没出现?
两种可能:
要出现完整的审批弹窗,需开启 Settings > Advanced > Use Hardware Acceleration。注意:需要重启才生效。

或者本次开机后你还没启动过 1Password,弹窗就不会出现。