前端自动化测试框架终极对比：Jest vs Mocha 如何选择最佳测试工具

祖崧革

357人浏览 · 2026-03-18 04:25:12

祖崧革 · 2026-03-18 04:25:12 发布

GDS Decompiler 完整指南：如何把 Godot 项目从字节码反编译回来

【免费下载链接】gdsdecomp Godot reverse engineering tools 项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp

GDS Decompiler 是一款面向 Godot 的逆向工程工具。它能把编译后的 GDScript 字节码（.gdc）反编译成可读源码，从 PCK、APK、EXE 里提取资源，还能重建出可继续编辑的完整工程。适合做项目备份找回、竞品分析、学习引擎脚本机制的开发者。

它到底是干什么的：GDS Decompiler 三大核心能力

完整项目恢复：从 PCK 到可编辑工程

这是它最核心的能力。给它一个 PCK、APK 或 EXE，它会一次性做完：加载全部资源、反编译所有 GDScript 脚本、恢复原始工程文件、把导入资源转回原始格式、把自动转换的二进制资源还原成文本、重建插件配置。

你拿到的不是散文件，而是一个能直接拖进 Godot 继续开发的工程。你上手时最典型的用法就是：手上只有发行版没有源码，跑一次恢复，核心逻辑基本完整拿回来。

批量反编译与资源提取：只取你要的部分

不想要整个工程，也可以只取一部分。它支持单独反编译 GDC 文件、用 --scripts-only 只处理脚本、列出包内文件清单，都能按通配符筛选范围。

场景：竞品分析。只想看某个目录下的玩法脚本？加一条筛选规则，很快就能拿到一批可读的 .gd 文件慢慢研究。

资源格式互转与 PCK 修补

它还能在文本和二进制之间批量互转 .res、.tscn 等文件，可以从目录创建新 PCK，也能往已有 PCK 里打补丁替换文件。

场景：教学演示。把二进制资源转成文本格式，一眼看清场景结构；改完再转回去或打进 PCK 验证效果，一个完整的"改—验"流程就闭环在自己的机器上。

从0到1跑起来：安装 GDS Decompiler 与两条常用命令

两种安装方式对比：

方式	步骤	适合谁
Scoop / 安装包	Windows 下执行 `scoop bucket add games` 再 `scoop install gdsdecomp`；其他平台从官方 Releases 获取	想开箱即用的人
源码编译	克隆到 Godot 的 modules/ 目录（命名 gdsdecomp），装好 rustup 与 .NET 10 SDK 后重新编译 Godot	要定制、参与开发的人

git clone https://gitcode.com/GitHub_Trending/gd/gdsdecomp

最常用的两条命令：

gdre_tools --headless --recover=game.pck --output=recovered

--recover 指定 PCK、APK、EXE 或已解压目录，--output 指定输出位置（不填则默认生成 <名称>_extracted）；加密项目再加 --key（64 位十六进制密钥）。

gdre_tools --headless --decompile=main.gdc --bytecode=4.3.0

--decompile 支持通配符和多个文件，--bytecode 指定字节码版本，填引擎版本号或 commit 哈希都可以。

第一次运行怎么看输出？ 重点看恢复日志里的三样东西：检测到的引擎版本（之后要用对应版本的 Godot 打开工程）、成功反编译的脚本数量、被跳过的文件列表。跳过几个文件是正常现象，不必紧张，后面"能走到多深"一节有说明。

遇到坑怎么办：四个高频问题的现象与解法

1. 解密失败、提示加密错误 现象：加载资源时反复报解密或加密相关错误。原因：密钥不对，或游戏用了非标准的自定义加密方案。解法：先用 --key 传正确的密钥；确认是自定义加密时，按自定义解密器文档写一个解密脚本挂上去。

2. 反编译结果报错、字节码不匹配 现象：反编译输出乱码或直接报错退出。原因：猜测的字节码版本和游戏实际用的不一致。解法：先跑 --list-bytecode-versions 查看支持的全部版本，再用 --force-bytecode-version 精确指定；版本演进明细可查 BYTECODE_HISTORY.md。

3. MD5 校验错误连成串 现象：提取过程中大量 checksum 错误刷屏。原因：文件本身损坏，或工具版本与包版本对不上。解法：加 --ignore-checksum-errors 继续流程，事后对关键文件单独抽查。

4. 恢复出的工程打不开、有编译错误 现象：工程导入 Godot 后报错较多。原因：你编辑用的 Godot 版本和原游戏的引擎版本不一致。解法：看恢复日志里标注的引擎版本，换对应版本的 Godot 打开工程。

能走到多深：版本兼容、验证指标与高级筛选

版本兼容性一览：

Godot 版本	脚本反编译	资源转换	完整恢复
4.x	支持	支持	支持
3.x	支持	支持	支持（引擎侧已停止构建更新）
2.x	支持	部分支持（2.x 模型未实现）	部分支持

结果验证看三个指标：反编译脚本数、资源转换率、未转换文件清单。建议恢复完成后，挑几个关键场景和脚本与原游戏对照抽查，确认玩法逻辑完整。

高级筛选与优化：--include / --exclude 支持 glob 通配，模式一般以 res:// 为根，** 表示递归子目录，裸写的 *.gdc 会被当作递归匹配；翻译恢复可用 --translation-hint 提供密钥提示文件（支持 csv、po、mo 等）；只想快速拿脚本时加 --scripts-only，能明显缩短耗时。