Work in progress
Godot documentation is being updated to reflect the latest changes in version
4.0. Some documentation pages may
still state outdated information. This banner will tell you if you're reading one of such pages.
The contents of this page are up to date. If you can still find outdated information, please open an issue.
Debugging and profiling¶
This section contains pages that provide guidance if you're looking at the engine code trying to find an underlying issue or an optimization possibility.
Debugging the editor¶
When working on the Godot editor keep in mind that by default the executable
will start in the Project Manager mode. Opening a project from the Project
Manager spawns a new process, which stops the debugging session. To avoid that
you should launch directly into the project using
For example, using
gdb directly, you may do this:
$ gdb godot > run -e --path ~/myproject
You can also run the editor directly from your project's folder. In that case,
-e option is required.
$ cd ~/myproject $ gdb godot > run -e
You can learn more about these launch options and other command line arguments in the command line tutorial.
If you're using a code editor or an IDE to debug Godot, check out our configuration guides, which cover the setup process for building and debugging with your particular editor.