C++头文件不引入类头文件时可正常使用该类的方案咨询

可行方案：使用不透明句柄（Opaque Handle）隐藏原类细节 #

你原本设想的直接在wrapper头文件中用Foo作为值类型返回的写法无法实现，因为C++中值类型的传递、返回都要求编译器提前知道类的大小、内存布局和构造/析构函数，必须引入原类头文件。通过不透明句柄的方案可以完全规避这个问题，wrapper头文件全程不依赖原库的任何头文件，bindgen可以正常解析。

具体实现代码 #

1. 闭源库原有头文件（仅wrapper.cpp编译时引用，完全不对外暴露）

// CompiledCode.hpp（闭源库提供的原头文件）
class Foo {
public:
    static Foo create();
    int doSomething(int param);
    // 其他原有成员方法
private:
    // 所有内部成员、布局完全隐藏
};

2. 给bindgen解析的wrapper头文件（无任何原库依赖）

用前向声明的不透明结构体作为句柄类型，类型安全性比直接用void*更高，bindgen会自动识别为合法的指针类型：

// wrapper.hpp
#ifdef __cplusplus
extern "C" {
#endif

// 前向声明不透明类型，外部完全不需要知道其内部结构
struct FooOpaque;
typedef struct FooOpaque* FooHandle;

// 所有操作都通过C风格接口暴露，无C++复杂语法，bindgen可直接解析
FooHandle create_foo();
int foo_do_something(FooHandle foo, int param);
void destroy_foo(FooHandle foo);

#ifdef __cplusplus
}
#endif

3. wrapper实现文件（编译时才引入原库头，对外隐藏实现细节）

// wrapper.cpp
#include "CompiledCode.hpp"
#include "wrapper.hpp"
#include <new>

extern "C" {

FooHandle create_foo() {
    // 将原类实例分配在堆上，指针转成不透明句柄返回
    return reinterpret_cast<FooHandle>(new(std::nothrow) Foo(Foo::create()));
}

int foo_do_something(FooHandle foo, int param) {
    // 句柄转回原类指针调用原有方法
    return reinterpret_cast<Foo*>(foo)->doSomething(param);
}

void destroy_foo(FooHandle foo) {
    // 配套释放接口，避免内存泄漏
    delete reinterpret_cast<Foo*>(foo);
}

}

方案优势 #

• wrapper.hpp全程不引入原库的任何头文件，bindgen只会看到纯C风格的简单类型和函数，不会触发原头文件的解析错误
• 类型安全有保障，不同类的不透明句柄无法混用，编译器会做基础校验
• 原库的所有C++特性、复杂语法都被完全屏蔽，不会影响跨语言绑定的生成

内容的提问来源于stack exchange，提问作者object-Object