调试工具概述¶
本指南将概述引擎中可用的调试工具。
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 中找到相关信息。
脚本编辑器调试工具和选项¶
脚本编辑器有自己的一套调试工具,用于断点和两个选项。断点工具也可以在调试器的**Debugger**标签中找到。

断点**按钮会像断点一样导致脚本的中断。**继续**使游戏在断点处暂停后继续。**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.

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