Omarchy 安装停止或失败：分阶段排查指南
定位 Omarchy 在 ISO 写入、USB 启动、选盘、格式化、软件安装或首次重启阶段停止的原因，再决定是否安全重试。
AMZDIR Editorial · 发布 · 更新
Omarchy 安装停止时，应先确认最后完成了哪个阶段，再决定是否重试。重写 USB、重复格式化和处理首次启动是三类不同操作。保存完整信息、屏幕和刚才的操作，避免一次安装失败演变成磁盘或数据损失。
目标或变更不清楚时立即停止
若安装器显示错误磁盘、Windows 分区、EFI 分区、恢复分区或意外的整盘擦除，应在确认格式化前退出。不要靠猜测改选另一块设备，也不要为了消除错误而删除分区。
先定位安装停止的阶段
| 最后完成的阶段 | 首先检查 | 安全的后续入口 |
|---|---|---|
| ISO 已下载 | 官方来源、文件完整性、当前签名或校验说明 | ISO 核验 |
| USB 已写入 | 写盘验证、目标 USB、安全弹出 | 制作 USB 启动盘 |
| 固件中已选择 USB | UEFI 入口与当前 Secure Boot/TPM 说明 | 配置 UEFI |
| 已打开安装器 | 键盘、网络、安装模式、目标盘身份 | 本页：安装器与选盘检查 |
| 已开始格式化 | 完整错误、供电、存储健康；不要假设已回滚 | 本页：安装过程中停止 |
| 安装器已报告完成 | 拔除 USB、内部 UEFI 入口、LUKS 密码 | 本页：首次重启 |
ISO 下载或 USB 写入停止
只从 Omarchy 官方网站重新下载 ISO。只有存在当前官方校验值或签名可供对照时，本地算出的哈希才有验证意义。写盘工具中应：
- 确认目标是可清空 USB，而不是外部备份盘；
- 等待写入与 validation 都完成；
- 保存完整验证错误；
- 修改内置磁盘前，先换 USB 接口或已知正常的可清空 USB 重试。
把 ISO 当普通文件复制到 USB 不会得到可启动介质。多个工具都在同一 USB 失败时，应优先怀疑介质或接口，不能通过关闭验证来绕过。
UEFI 中没有 USB 或无法启动
完整关机后打开一次性固件启动菜单，选择明确标记为 UEFI 的入口。启动按键以硬件手册为准，Secure Boot 与 TPM 要求以 Omarchy 当前官方页面为准。
关闭 TPM 不等于 Clear TPM。Windows 电脑必须保留 BitLocker 恢复密钥，不要重置安全处理器。也不要为了测试 USB 是否出现而随意切换 SATA、AHCI 或 RAID 模式。
安装器无法使用磁盘或分区
若环境能打开 Shell，先收集只读清单：
lsblk -o NAME,SIZE,MODEL,TRAN,TYPE,FSTYPE,MOUNTPOINTS用品牌、容量、连接类型和现有分区，与启动前记录交叉核对。教程里的 /dev/nvme0n1 只是示例，在你的机器上可能指向错误磁盘。
双系统的目标区域必须是未分配空间，安装器必须使用 Free space install。出现 BitLocker 已启用错误时，应回到 Windows 关闭设备加密，并等待解密完成。不要删除 Windows、EFI 或恢复分区，具体见Windows 分区安装指南。
格式化或软件安装阶段停止
官方手册说明，快速硬件可在一分钟内完成，较旧电脑通常也不应超过约五分钟；但持续变化的进度画面不等于卡死。保持供电和网络稳定，先记录持续出现的完整错误。
如果格式化已经开始：
- 不要假设旧文件系统仍然完整；
- 在定位失败阶段前，不要重跑 Full disk 或 Free space install；
- 存储仍有活动或进度仍在变化时，不要强制断电；
- 拍下完整画面，并记录是整盘、空闲空间、VM 还是脚本路径；
- 若新旧系统都无法启动，使用事先准备的恢复介质，不要试改 EFI 文件。
常规的 omarchy debug 只适用于已经能启动的 Omarchy。首次成功启动之前，应保存安装器输出和硬件信息，不能把“执行过安装器”当作安装成功。
安装完成但首次重启失败
- 只有安装器报告完成后才拔出 USB；
- 若再次进入安装器，从 UEFI 菜单选择内部磁盘；
- 磁盘解锁应输入安装时设置的加密密码；该启动前阶段不能使用蓝牙键盘；
- 双系统菜单中 Windows 消失时，先确认 UEFI 仍有
Windows Boot Manager。Omarchy 能启动后，使用文档中的limine-scan流程，不要覆盖 EFI 文件； - 系统能启动但桌面、网络、显示或登录失败时，继续看安装后故障排查指南。
求助前收集什么
- 电脑型号、CPU 架构、显卡、存储品牌与容量；
- Omarchy ISO 来源和下载日期；
- USB 写盘工具及 validation 是否通过；
- 整盘、Free space、VM、无人值守或 Arch 脚本路径；
- 最后成功画面与完整错误；
- 是否已开始格式化，Windows 或旧系统是否仍能启动；
- 一张清晰照片，公开前遮住序列号、用户名、Wi-Fi 名称、IP、挂载路径和令牌。
返回 Omarchy 手动安装指南比较不同路径。来源：Omarchy Getting Started、Dual Boot Install、Troubleshooting。