多Cython模块共享C全局变量引发段错误问题求助

I’ve run into exactly this issue before—when you declare global C variables via extern in multiple Cython modules, each extension ends up with its own copy of that variable, not a shared instance. That’s exactly why your test script crashes: itf.jrtk_Init() initializes the interp pointer in the itf module, but the itfMain module’s interp is still NULL, leading to a segmentation fault when tagsTest() tries to use it.

Here’s how to fix this step by step:

1. Centralize the Global Variable Definition #

Instead of letting each Cython module declare the global variable separately, define it in a single C file and expose it via a header. This ensures all modules reference the same memory address.

First, create two new files:

• global_state.h:

#include <tcl.h>
// Declare the global variable for external use
extern Tcl_Interp *interp;

• global_state.c:

#include "global_state.h"
// Define the actual global variable (only one instance exists)
Tcl_Interp *interp = NULL;

Update your c_itfMain.pxd to reference this header instead of declaring the variable directly:

cdef extern from "global_state.h":
    ctypedef struct Tcl_Interp:
        pass
    Tcl_Interp *interp

2. Update Your Build Configuration #

Modify setup.py to include the global_state.c file in both of your Cython extensions. This ensures the variable’s definition is linked into each module, so they all resolve to the same instance:

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

# Adjust include_dirs and library_dirs to match your system paths
extensions = [
    Extension(
        "itf",
        sources=["itf.pyx", "global_state.c"],
        libraries=["jrtk", "tcl"],
        include_dirs=["../jrtk/include", "/usr/include/tcl"],
        library_dirs=["../jrtk/build", "/usr/lib"]
    ),
    Extension(
        "itfMain",
        sources=["itfMain.pyx", "global_state.c"],
        libraries=["jrtk", "tcl"],
        include_dirs=["../jrtk/include", "/usr/include/tcl"],
        library_dirs=["../jrtk/build", "/usr/lib"]
    )
]

setup(
    name="jrtk_cython_wrapper",
    ext_modules=cythonize(extensions)
)

If you want to avoid compiling global_state.c twice, you can compile it into a static library first and link that to both extensions instead—this is cleaner for larger projects.

3. Verify the Shared Instance #

To confirm everything works, add debug prints to check the memory address of interp in both modules:

In itf.pyx:

from c_itfMain cimport interp

def jrtk_Init():
    global interp
    interp = Tcl_CreateInterp()
    print(f"itf: interp address = {interp}")
    # Your existing initialization logic here

In itfMain.pyx:

from c_itfMain cimport interp

def tagsTest():
    print(f"itfMain: interp address = {interp}")
    if interp is NULL:
        raise RuntimeError("Tcl interpreter not initialized!")
    # Your existing test logic here

When you run your test script, both addresses should match. If they do, the segmentation fault should be gone—tagsTest() will now use the properly initialized interpreter from itf.jrtk_Init().

Why This Happened in the First Place #

When you use extern in a Cython .pxd without linking to a single definition of the variable, the linker creates a weak symbol for each module. Each extension ends up with its own copy of interp, so changes in one module don’t affect the other. This leads to uninitialized pointers and the segmentation fault you saw.

内容的提问来源于stack exchange，提问作者Simon T.