Files
godot-contributing-docs/engine/debugging/index.rst
2025-07-29 21:52:31 +02:00

49 lines
1.4 KiB
ReStructuredText

:allow_comments: False
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.
.. toctree::
:maxdepth: 1
:name: toc-devel-cpp-debug-profiling
using_cpp_profilers
using_sanitizers
macos_debug
vulkan/index
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 ``-e`` and ``--path`` launch
options.
For example, using ``gdb`` directly, you may do this:
.. code-block:: none
gdb godot
> run -e --path ~/myproject
You can also run the editor directly from your project's folder. In that case,
only the ``-e`` option is required.
.. code-block:: none
cd ~/myproject
gdb godot
> run -e
You can learn more about these launch options and other command line arguments
in the :ref:`command line tutorial <doc_command_line_tutorial>`.
If you're using a code editor or an IDE to debug Godot, check out our
:ref:`configuration guides <doc_configuring_an_ide>`, which cover the setup
process for building and debugging with your particular editor.