如何在Python C++扩展中隐藏结构体成员使其对Python层不可访问？

方案1：通过Python扩展机制隐藏属性（最简单直接） #

Python层能否访问扩展类型的属性，完全由你在PyTypeObject中注册的成员决定，和C++的访问修饰符无关。不需要修改结构体的成员权限，只要不在tp_members数组中添加m_is_surface和m_is_stream，Python用户就无法直接访问这些属性。

1. 保持结构体定义（无需private） #

// 注意：避免和Python API的PyType重名，建议改为PyMyType
typedef struct {
    PyObject_HEAD
    std::string region;
    std::string stream;

    bool m_is_surface = false;
    bool m_is_stream = false;
} PyMyType;

2. 配置PyTypeObject的tp_members #

只暴露需要让Python访问的成员：

static PyMemberDef PyMyType_members[] = {
    {"region", T_STRING, offsetof(PyMyType, region), 0, "Region name"},
    {"stream", T_STRING, offsetof(PyMyType, stream), 0, "Stream name"},
    // 不要添加m_is_surface和m_is_stream
    {NULL}  // 数组结束标记
};

static PyTypeObject PyMyType_Type = {
    PyVarObject_HEAD_INIT(NULL, 0)
    .tp_name = "my_module.PyMyType",
    .tp_basicsize = sizeof(PyMyType),
    .tp_itemsize = 0,
    .tp_flags = Py_TPFLAGS_DEFAULT,
    .tp_members = PyMyType_members,
    .tp_init = (initproc)PyMyType_init, // 你的初始化函数
    // 其他方法注册...
};

此时Python用户尝试访问instance.m_is_surface会直接抛出AttributeError，同时你的初始化函数可以正常访问结构体成员，不会有C++权限问题。

方案2：C封装+友元声明（兼顾C代码内的访问控制） #

如果需要在C++代码内部限制只有指定函数能操作m_is_surface和m_is_stream，可以把结构体改成类，将私有成员隐藏，并把初始化函数和相关方法声明为友元：

1. 定义C++类替代结构体 #

class PyMyType : public PyObject {
private:
    bool m_is_surface = false;
    bool m_is_stream = false;

    // 声明友元，允许指定函数访问私有成员
    friend int PyMyType_init(PyMyType* self, PyObject* args, PyObject* kwds);
    friend PyObject* PyMyType_custom_method(PyMyType* self, PyObject* args);
    // 添加所有需要访问私有成员的函数作为友元

public:
    PyObject_HEAD // 必须放在public区域，Python API需要访问内部PyObject结构
    std::string region;
    std::string stream;
};

2. 调整PyTypeObject配置 #

因为类继承自PyObject，offsetof仍可正常使用：

static PyMemberDef PyMyType_members[] = {
    {"region", T_STRING, offsetof(PyMyType, region), 0, "Region name"},
    {"stream", T_STRING, offsetof(PyMyType, stream), 0, "Stream name"},
    {NULL}
};

static PyTypeObject PyMyType_Type = {
    PyVarObject_HEAD_INIT(NULL, 0)
    .tp_name = "my_module.PyMyType",
    .tp_basicsize = sizeof(PyMyType),
    .tp_itemsize = 0,
    .tp_flags = Py_TPFLAGS_DEFAULT,
    .tp_members = PyMyType_members,
    .tp_init = (initproc)PyMyType_init,
    // 注册友元声明的方法...
};

这种方式既阻止了Python用户访问私有成员，也限制了C++代码中只有指定函数能操作这些成员，同时初始化函数可以正常访问。

注意事项 #

• 不要用PyType作为自定义类型名，Python的C API中已有同名类型，容易引发冲突。
• 方案2中PyObject_HEAD必须放在类的public区域，否则Python API无法正确处理对象结构，会导致崩溃或未定义行为。

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