调试工具概述

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

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

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

调试器面板

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

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

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

下面是这些选项的说明:

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

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

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

另外,在安卓系统上,游戏采用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 部分.