如何在Cython中访问C++类的静态内联成员变量

核心问题分析 #

你碰到的问题是Cython对C静态成员的声明、访问语法不匹配：直接用.访问会被Cython转成错误的C语法（应该用::），但在Cython声明里加static又会触发语法错误。

正确实现步骤 #

1. C++侧的类与成员定义（示例）

   namespace my::name::space {
       class MyClass {
       public:
           static inline int LIFE = 42;
           int non_static_val = 100;
       };
   }
   

2. Cython中的声明与访问方式

   • 在.pyx文件中声明C命名空间和类时，不要在成员前加static修饰符，通过cdef extern from块指定C语法即可：

     cdef extern from "your_header.h" namespace "my::name::space":
         cdef cppclass MyClass:
             int LIFE  # 此处无需加static，Cython会自动识别静态成员的访问逻辑
             int non_static_val
     

   • 访问静态成员时，直接用类名加.（Cython编译时会自动转为C++的::语法）：

     def get_life():
         return MyClass.LIFE  # 最终编译为my::name::space::MyClass::LIFE
     

关键配置说明 #

确保setup.py启用C编译，适配C版本（因使用了inline static变量，需C++17及以上）：

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

ext_modules = [
    Extension(
        "your_module",
        ["your_module.pyx"],
        language="c++",
        extra_compile_args=["-std=c++17"],
    )
]

setup(
    name="your_module",
    ext_modules=cythonize(ext_modules),
)

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