调试工具概述

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

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

Finally, you have options to debug the game running on a remote device and to reload changes to your scenes or your code while the game is running.

Debugger Panel

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

Debug menu options

There are a few common debug options you can toggle on or off when running your game in the editor, which can help you in debugging your game.

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

../../_images/overview_debug.png

下面是这些选项的说明:

使用远程调试部署

When exporting and deploying, the resulting executable will attempt to connect to the IP of your computer for debugging.

使用网络文件系统进行小型部署

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

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

另外,在安卓系统上,游戏采用USB线部署,加快部署速度。

显示碰撞区域

This option makes collision shapes and raycast nodes visible in the running game.

显示导航

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

同步场景修改

With this option, any change you make to a scene in the editor at runtime appears instantly. When used remotely on a device, this is more efficient with the network filesystem.

同步脚本变更

Any script that is saved will be reloaded on the running game. When used remotely on a device, this is more efficient with the network filesystem.

脚本编辑器调试工具和选项

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

../../_images/overview_script_editor.png

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

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

警告

如果代码是:ref:`在线程<doc_using_multiple_threads>中运行,断点不会中断。这是当前GDScript调试器的一个限制。

Debug project settings

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

Settings

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

GDScript

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

Shapes

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

Remote in scene dock

When running a game in the editor two options appear at the top of the Scene dock, Remote and Local. While using Remote you can inspect or change the nodes' parameters in the running project.

../../_images/overview_remote.png

注解

Some editor settings related to debugging can be found inside the Editor Settings, under the Network > Debug and Debugger sections.