Steam Deck Decky 报错排查指南

Decky Loader 是 Steam Deck 上最受欢迎的插件加载器之一，允许用户扩展系统功能。然而，在使用过程中可能会遇到各种报错。本文整理了常见的错误类型及其解决方法。

常见报错类型

• “Failed to load plugin”：插件文件损坏或不兼容当前版本。
• “Module not found”：依赖缺失或路径配置错误。
• 黑屏/卡死：插件冲突或资源占用过高。
• Decky 无法启动：服务未正确安装或权限问题。

通用解决步骤

1. 确保 Steam Deck 系统和 Decky Loader 均为最新版本。
2. 进入桌面模式（Desktop Mode），检查插件目录 ~/.config/decky/plugins/ 是否完整。
3. 尝试禁用所有插件，逐个启用以定位问题插件。
4. 查看日志文件：~/.local/share/decky/loader.log 获取详细错误信息。
5. 必要时通过命令行重新安装 Decky：

   curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh

获取更多帮助

如果问题仍未解决，建议查阅官方文档或社区讨论：

• Decky Loader GitHub 仓库
• Steam Deck Homebrew Discord