麒麟os安装卡在99%时，应依次确认后台是否运行并延长等待、强制终止安装进程后tty手动修复、检查分区状态与挂载完整性、禁用secure boot并重建uefi启动项、更换校验通过的安装介质。
如果您在安装麒麟OS系统时进度条长期停滞在99%，既不继续也不报错，且无明显磁盘或CPU活动，则很可能是安装程序在执行根文件系统同步、初始化配置、固件写入或启动项注册等后台操作时遭遇阻塞。以下是针对该问题的多种应急处理方法：
一、确认后台是否仍在运行并延长等待时间
安装卡在99%常为正常耗时阶段，系统可能正在执行fsync刷盘、生成initramfs、安装GRUB或配置网络服务，此时界面无反馈但底层持续工作。需通过物理指标判断是否真卡死。
1、观察主机硬盘指示灯是否间歇性闪烁；
2、使用另一台设备通过SSH连接安装机（若已配置网络且开启sshd）：ssh 用户名@安装机IP，执行ps aux | grep -E "(install|dpkg|grub)"查看关键进程是否存在；
3、若发现dpkg --configure -a或grub2-install进程处于R（运行）或D（不可中断睡眠）状态，保持通电、勿强制重启，静候最多90分钟；
4、若硬盘灯完全熄灭且SSH无法连接，进入下一步。
二、强制终止安装进程并切换至TTY执行手动修复
当图形安装器无响应且无后台活动时，可中断GUI安装流程，转入文本终端接管安装任务，避免重装。该方式保留已写入的系统分区内容，仅修复中断点。
1、按Ctrl + Alt + F2切换至TTY2终端；
2、输入安装时设定的用户名及密码登录；
3、执行sudo ps aux | grep ubiquity（麒麟OS安装器进程名为ubiquity），记录其PID；
4、执行sudo kill -9 PID号强制终止安装器；
5、执行sudo ubiquity --no-migration-assistant --debug以调试模式重启安装器，观察终端输出中的错误行（如failed to mount /boot/efi或cannot chroot into target）；
6、根据错误提示修正对应问题后，再次运行该命令继续安装。
三、检查目标磁盘分区状态与挂载完整性
99%卡顿常见于安装器尝试挂载/boot、/boot/efi或/swap分区失败，但未抛出明确错误。此时需人工验证分区表结构、文件系统一致性及挂载点权限。
1、在TTY中执行lsblk -f，确认目标磁盘（如/dev/sda）存在且各分区（如sda1为/boot/efi、sda2为/）标注了正确FSTYPE（vfat、ext4）；
2、对/boot/efi分区执行sudo fsck.vfat -a /dev/sda1，对根分区执行sudo e2fsck -f /dev/sda2；
3、手动挂载验证：sudo mkdir -p /mnt/target && sudo mount /dev/sda2 /mnt/target && sudo mount /dev/sda1 /mnt/target/boot/efi；
4、若任一挂载命令报错（如mount: wrong fs type），需重新分区并格式化对应分区；
5、挂载成功后，执行sudo ubiquity --no-migration-assistant --target /mnt/target指定已挂载路径继续安装。
四、禁用安全启动并重置UEFI启动项
在部分OEM笔记本上，Secure Boot启用状态下可能导致GRUB模块加载失败，安装器在最后阶段反复尝试签名验证而停滞。需临时关闭安全机制并重建EFI启动条目。
1、重启机器，在开机自检画面按F2/F10/Del键进入UEFI设置；
2、定位到Security → Secure Boot选项，将其设为Disabled；
3、保存退出并重新进入麒麟OS安装环境；
4、在TTY中执行sudo mkdir -p /mnt/efi && sudo mount /dev/sda1 /mnt/efi；
5、执行sudo grub2-install --target=x86_64-efi --efi-directory=/mnt/efi --bootloader-id=KylinOS --recheck；
6、执行sudo grub2-mkconfig -o /mnt/efi/EFI/KylinOS/grub.cfg；
7、返回图形安装器界面，点击“前进”跳过已执行步骤，直接完成剩余配置。
五、更换安装介质并校验镜像完整性
USB安装盘制作不良、U盘控制器兼容性差或ISO镜像下载损坏，会导致写入过程中断或数据校验失败，表现为99%卡死且无任何日志输出。必须排除介质层面故障。
1、在另一台Linux机器上，使用sha256sum 麒麟OS镜像.iso比对官网公布的SHA256值；
2、若校验失败，重新下载镜像；
3、使用dd命令而非图形化工具制作启动盘：sudo dd if=kylinos.iso of=/dev/sdX bs=4M status=progress oflag=sync（X为U盘设备号，如b）；
4、更换为USB 2.0接口或不同品牌U盘重试安装；
5、若仍卡在99%，尝试在BIOS中将SATA模式由RAID/AHCI切换为IDE兼容模式后重试。
