调试工具概述

本指南将概述引擎中可用的调试工具.

Godot自带强大的调试器和剖析器, 可以追踪bug, 在运行时检查你的游戏, 监控重要指标, 并测量性能. 它还提供了在运行游戏中可视化碰撞框和导航多边形的选项.

最后, 你可以选择调试在远程设备上运行的游戏, 并在游戏运行时重新加载对你的场景或代码的修改.

调试器面板

Godot的许多调试工具都是Debugger面板的一部分, 你可以在调试器面板中找到相关信息.

在编辑器中运行游戏时, 有几个常见的调试选项可以切换为开或关, 以帮助你调试游戏.

您可以在 Debug 编辑器菜单中找到这些选项.

下面是这些选项的说明:

当导出和部署时, 产生的可执行文件将尝试连接到你的计算机的IP上进行调试.

这个选项加快了在远程设备上进行大足迹游戏的测试.

当 Small Deploy with Network FS 开启时, 部署游戏不是导出整个游戏, 而是建立一个最小的可执行文件. 然后, 编辑器通过网络提供项目中的文件.

另外，在 Android 系统上，游戏采用 USB 线部署，加快部署速度。

这个选项使碰撞形状和射线传输节点在运行的游戏中可见.

可以在运行的游戏的时候看到导航网格和多边形.

使用此选项, 在运行时对编辑器中的场景所做的任何更改都会立即显示. 当在设备上远程使用时, 这对网络文件系统来说更为有效.

任何被保存的脚本都会被重新加载到正在运行的游戏上. 当在设备上远程使用时, 这对网络文件系统来说更有效率.

脚本编辑器有自己的一套调试工具, 用于断点和两个选项. 断点工具也可以在调试器的 Debugger 标签中找到.

断点按钮会像断点一样导致脚本的中断. 继续使游戏在断点处暂停后继续. Step Over 进入下一行代码, 如果可能的话, Step Into 进入一个函数. 否则, 它与 Step Over 做同样的事情.

在场景关闭后, Keep Debugger Open 选项可使调试器保持打开状态. 而 Debug with External Editor 选项可以让你用外部编辑器调试游戏.

警告

如果代码是在线程中运行, 断点不会中断. 这是当前GDScript调试器的一个限制.

在项目设置中, 有一个调试类别, 有三个子类别, 控制不同的东西.

这些都是一些常规的设置, 比如将当前的FPS打印到输出面板, 剖析时的最大函数量等.

这些设置允许你切换特定的GDScript警告, 比如未使用的变量. 您也可以完全关闭警告.

Shapes中你可以调整形状的颜色, 这些形状只出现在调试的目的, 如碰撞和导航形状.

当在编辑器中运行一个游戏时, 有两个选项出现在 Scene 栏目的顶部, 即 Remote 和 Local . 当使用 Remote 时, 你可以检查或改变运行项目中的节点参数.

注解

一些与调试有关的编辑器设置可以在 Editor Settings 内找到, 在 Network > Debug and Debugger 部分.