SuperAPI AI 工具集

godot-testing

测试与质量

查看项目

更新于 10-15 22:40

技能介绍

用途:为 Godot 4.3+ 项目提供测试驱动开发(TDD)方法,覆盖 GUT(Godot Unit Testing)与 gdUnit4 两个框架,支持 GDScript 与 C#。

主要能力:框架选择建议(纯 GDScript 项目用 GUT,C# 或混合项目用 gdUnit4)、完整 RED-GREEN-REFACTOR 示例、测试目录结构与命名规范、常用断言对照、常见测试模式(场景节点、信号、Mock/替身、异步),以及在 CI 中运行测试。

使用方式:测试文件按框架命名,GUT 的 GDScript 用 test_*.gd,gdUnit4 的 C# 用 *Test.cs 并加 [TestSuite]。运行方面,GUT 通过 godot --headless --path . -s addons/gut/gut_cmdln.gd;gdUnit4 使用 --add-gdunit-test-runner 参数或编辑器 GdUnit Tests 面板。CI 可在推送或 PR 时以无头模式运行,失败时以非零状态退出。

适用场景:希望用 TDD 提升 Godot 项目质量的团队与个人,尤其需要统一测试规范或搭建 CI 测试流程时。

限制与注意:不测试 Godot 引擎内部、私有实现细节、像素级渲染输出、无容差的时序浮点、内置一行的包装属性,也不穷举所有非法输入。测试类需继承正确基类(GutTest / GdUnit4.GdUnitTestSuite),加入场景树的节点使用 add_child_autofree 或 auto_free,信号先监听后触发,Mock 仅用于外部依赖。异步测试使用明确超时而非 sleep。具体代码示例与本技能完整内容暂未提供。