如何通过断点调试Cython？Windows下GDB及编辑器配置指南

Launching Virtual Environment Python in GDB #

To use your project's virtual environment Python with msys64's GDB, point GDB directly to the full path of the venv's python.exe using msys64's path syntax:

1. Open msys64 shell and navigate to your project directory.
2. Start GDB with: gdb
3. Inside GDB, load the venv Python executable:

   file /c/path/to/your/project/venv/Scripts/python.exe
   

   Replace /c/path/to/your/project with your actual Windows path converted to msys64 format (e.g., C:\my_project becomes /c/my_project).
4. Run your wrapper script with:

   run wrapper.py your_command_line_args
   

Setting Breakpoints in Cython .pyx Files #

To debug lines in your .pyx files, first compile the Cython module with debug symbols enabled:

Step 1: Recompile with Debug Flags #

Modify your setup.py to include debug directives and disable optimizations:

from setuptools import setup
from Cython.Build import cythonize
from setuptools.extension import Extension

extensions = [
    Extension(
        "cython_main_module",
        ["cython_main_module.pyx"],
        extra_compile_args=["-g", "-O0"],  # Debug symbols + no optimizations
        extra_link_args=["-g"]
    )
]

setup(
    ext_modules=cythonize(
        extensions,
        compiler_directives={"linetrace": True, "language_level": 3}
    )
)

• linetrace: True generates line number mappings between .pyx and the compiled C code.
• -g adds debug symbols; -O0 disables optimizations (critical for accurate breakpoint mapping).

Step 2: Set Breakpoints in GDB #

Once recompiled, set breakpoints directly using your .pyx file and line number:

break cython_main_module.pyx:42

Replace 42 with the line number in your .pyx file where you want to break. If GDB can't find the .pyx file, add the source directory manually:

directory /c/path/to/your/cython/source/files

Editor/IDE Debugging (Like PyCharm) #

PyCharm's native Python debugger doesn't support direct debugging of compiled Cython code. However, you have two practical options:

• Use CLion: JetBrains' C/C++ IDE can attach to the running Python process and debug the Cython-generated code, provided you compiled with debug symbols. You can map breakpoints back to .pyx files if debug info is properly included.
• External Tool Integration: In PyCharm, configure an external tool to launch msys64's GDB with pre-defined commands. This lets you trigger debugging from PyCharm, though you'll still use GDB's command-line interface for control.

Debugging Workflow Summary #

1. Recompile your Cython module with debug symbols and no optimizations.
2. Launch GDB and load your virtual environment's Python executable.
3. Set breakpoints using your .pyx file path and line number.
4. Run your wrapper script via GDB and use standard GDB commands (next, step, print, continue) to debug.

内容的提问来源于stack exchange，提问作者Zain