用途:为 Godot 4.3+ 项目提供系统化调试方法,同时支持 GDScript 与 C#。
主要能力与用法: 打印调试:print() 输出一般值;print_rich() 支持 BBCode 着色;push_error()/push_warning() 带堆栈跟踪但不中断执行;print_debug() 仅在调试构建出现;printerr() 输出到 stderr。C# 对应 GD.Print、GD.PrintRich、GD.PushError、GD.PushWarning、GD.PrintErr。 断点与远程调试器:在脚本编辑器行号左侧点击或用 F9 切换断点;GDScript 可用 breakpoint 语句触发程序化断点,C# 用 System.Diagnostics.Debugger.Break()。暂停后可查看堆栈帧、局部/成员/全局变量,并使用 F11 步入、F10 步过、Shift+F11 步出、F5 继续。 远程场景检查:Debugger > Remote 查看运行中的实时场景树、检查并即时修改节点属性。 Monitors:查看 FPS、处理/物理耗时、显存、对象与节点数、物理碰撞对、音频延迟等实时指标。 信号调试:用 node.get_signal_connection_list("signal_name") 检查连接,常见问题包括重复连接、释放时未断开、处理器签名不匹配。 常见报错与修复:如 Node not found、空实例调用、物理查询期间修改状态(需 set_deferred)、不存在函数、循环引用、栈溢出、Already connected、数组越界、音频欠载等均有对应处理方式。 性能调试:Debugger > Profiler 查看各函数 Self 时间与调用次数,按 Self 排序定位瓶颈。 场景树调试:print_tree_pretty() 输出场景树;@tool 节点可实现 _get_configuration_warnings()。 系统方法:Reproduce → Isolate → Hypothesis → Trace → Fix → Verify → Add a Test,并提供实现清单(如 await 后用 is_instance_valid() 防护、修复后写回归测试)。
限制:具体平台、收费、价格与效果信息资料暂未提供。