错误代码 / 症状对照表
遇到问题？在下表中查找对应的错误信息或症状：
| 错误 / 症状 | 原因 | 解决方案 |
|---|---|---|
"running in a new version of GD than Geode targets" | GD 版本太新，Geode 尚未适配 | 等待 Geode 更新，或降级 GD 版本 |
| Geode 按钮不显示 | GD 更新导致 Geode 失效，或安装不完整 | 重新安装 Geode；确认 GD 版本与 Geode 版本兼容 |
"Geode not installed"（Android） | 安装文件损坏或 GD 来源问题 | 卸载 GD 和 Geode，从 Play Store 重新安装 GD，再装 Geode |
"failed to link libraries"（移动端） | GD 安装来源不是 Play Store | 确保从 Play Store 安装正版 GD |
| XINPUT1_4.DLL 更新失败 | 文件权限问题或杀软拦截 | 关闭杀软、以管理员身份运行安装器 |
| 模组导致游戏崩溃 | 单个模组与当前版本不兼容 | 启动时按住 Shift 键禁用所有模组，逐个排查 |
| macOS 上 Geode 不显示 | Wine 兼容性问题 | 参考 GitHub Issue #584 |
| 更新后丢失模组 | GD/Geode 版本不匹配 | 重新安装模组；检查版本兼容性 |
| 游戏启动白屏 | 显卡驱动问题或模组冲突 | 更新显卡驱动；按住 Shift 启动 GD 禁用模组 |
| 模组安装后不生效 | 未重启 GD，或模组需要其他依赖 | 重启 GD；检查模组是否有依赖项 |
通用排障步骤
如果上表中没有找到你的问题，按以下步骤排查：
🔧 通用排障流程
- 1. 确认版本兼容 — 检查你的 GD 版本和 Geode 版本是否匹配（版本对照表）
- 2. 按住 Shift 启动 GD — 这会禁用所有模组，确认问题是否由模组引起
- 3. 重新安装 Geode — 下载最新版安装器重新运行
- 4. 逐个禁用模组 — 如果按住 Shift 能正常启动，说明是模组问题，逐个禁用排查
- 5. 查看日志文件 — Geode 日志位于
%LocalAppData%/GeometryDash/geode/geode_log.txt
按住 Shift 启动 GD
这是 Geode 最重要的排障技巧。按住 Shift 键的同时启动 GD， Geode 会跳过加载所有模组，让你确认问题是否由模组引起。
如果按住 Shift 启动后问题消失，说明是某个模组导致的。 接下来可以逐个启用模组，找出问题模组。
查看日志文件
Geode 会生成详细的日志文件，记录启动过程中的所有信息：
- Windows：
%LocalAppData%/GeometryDash/geode/geode_log.txt - Mac：
~/Library/Application Support/GeometryDash/geode/geode_log.txt - Android：
/storage/emulated/0/Android/data/com.robtop.geometrydash/geode/geode_log.txt
日志文件中包含错误信息，可以帮助你或开发者定位问题。
向开发者报告 Bug
如果问题持续存在，可以向 Geode 开发者报告：
- GitHub Issues — 技术问题
- Discord — 社区讨论
报告时请提供：GD 版本、Geode 版本、错误信息、日志文件内容。