Omarchy 中文指南
维护与排错

Omarchy 故障排查:黑屏、网络与快捷键问题

用可恢复的顺序排查 Omarchy 黑屏、启动、网络、显示器、声音、输入和快捷键问题,避免盲目重装。

排错的目标不是“尽快输入最多命令”,而是保存证据并缩小问题范围。开始前记录最近一次正常时间、刚做过的更新或配置更改,以及问题是否每次都能复现。

先判断影响范围

现象先问的问题
单个应用卡死其他窗口、终端和输入是否正常?
快捷键失效物理键、当前布局和内置热键表是否一致?
无网络只有 DNS 失败,还是网卡根本没有连接?
黑屏能否切换 TTY,显示器是否有信号,是否刚改显卡/显示配置?
无法启动UEFI 是否看到启动项,磁盘是否解锁,错误出现在哪一阶段?

保存现场

拍下或复制完整错误,记录时间、硬件型号和当前版本。日志可能包含用户名、主机名、IP、Wi-Fi 名称或令牌,公开前先脱敏。不要只截取最后一行,也不要在收集证据前反复重启。

一次只验证一个假设

从低风险到高风险:

  1. 重现问题并确认范围;
  2. 撤销最近一个可逆的用户配置;
  3. 使用系统提供的诊断或帮助入口;
  4. 查阅当前官方手册和已知问题;
  5. 在保留日志后重启相关应用或会话;
  6. 只有在恢复路径明确时才回退快照或修改系统包。

常见误区

  • 直接重装:会清除现场,却不证明硬件或配置问题已解决;
  • 复制旧命令:版本、包名与配置路径可能已经变化;
  • 一次改很多项:即使恢复正常,也无法知道是哪项有效;
  • 把快照当备份:磁盘故障时两者可能一起丢失;
  • 把秘密粘贴到论坛:先删除 Cookie、令牌、密钥和个人路径。

黑屏与显示问题

先检查线缆、输入源和另一台显示器;再判断是否能进入 TTY 或看到启动日志。多显卡与外接屏问题要记录 GPU、驱动、接口和刷新率。不要在看不到结果时连续覆盖显示配置。

网络问题

分别验证链路、IP、网关、DNS 和单个网站。浏览器打不开网页并不一定是 Wi-Fi 断开;VPN、代理、系统时间和 DNS 都可能造成相似现象。

何时求助

提供版本、硬件、复现步骤、预期、实际结果、完整但已脱敏的错误,以及你已经验证过的步骤。先搜索官方 Troubleshooting 与 FAQ,再提交最小问题描述。

On this page