Bazzite 常见问题排查与修复方法
Bazzite 作为一款基于 Fedora Atomic 的 OCI 镜像，为 Steam Deck 和桌面电脑提供了出色的游戏体验。然而在使用过程中，用户可能会遇到各种技术问题。本手册将详细介绍 Bazzite 的常见问题及其解决方案，帮助您快速恢复系统功能。
系统启动与引导问题
EFI 路径修复
在最近的更新中，Bazzite 修复了 fwupd 的 EFI 路径问题。如果您遇到固件更新失败的情况，请检查 EFI 分区是否正确挂载。
解决方案： 运行以下命令修复 EFI 路径：
ujust fix-efi-path
GRUB 配置目录缺失
某些情况下，运行 grub2-switch-to-blscfg 时可能出现目录缺失错误。
解决方案： 系统已通过更新自动修复此问题。如果仍然遇到此错误，请确保系统已更新至最新版本。
游戏模式问题排查
帧率控制异常
Bazzite 为 Gamescope 提供了修补后的 Mesa，确保正确的帧率控制。如果发现帧率不稳定：
- 检查 Gamescope 日志：
ujust post-gamescope-logs - 验证 GPU 驱动程序状态
- 重启 Gamescope 会话
音频问题处理
蓝牙设备导致系统无法挂起： 这是已知问题，已在最新版本中修复。
解决方案： 更新系统并重启：
rpm-ostree upgrade && systemctl reboot
硬件兼容性问题
NVIDIA 显卡问题
对于使用 NVIDIA 专有驱动的用户，Bazzite 提供了专门的 NVIDIA 版本。常见问题包括：
- 旧版 NVIDIA 硬件支持： 系统会自动检测并应用相应配置
- NVK 驱动问题： 注意 Mesa 的 NVIDIA GPU 开源选项 NVK 目前仍容易出现错误
掌机设备特殊配置
不同品牌的掌机设备需要特定的设置调整：
- ROG Ally X： 在连接底座时优先使用 HDMI 音频输出
- Steam Deck： 自动应用 SteamOS 的内核参数
- 其他手持设备： 参考 Handheld Wiki 获取详细配置指南
软件安装与更新问题
Python 包安装错误
由于移除了 pip 安装的包并使用新制作的 rpm 包，解决了在分层某些包时出现的 Python 错误。
解决方案： 使用系统提供的 rpm 包而非 pip 安装：
ujust install-required-packages
更新大小优化
Bazzite 引入了镜像重分块功能，将更新大小降低了 85%。如果更新过程中遇到问题：
- 检查网络连接
- 使用
rpm-ostree status查看当前系统状态 - 如有需要，可回滚到上一版本
