如何使用Swig创建跨编译器兼容的C++库并生成头文件包装？

针对你提到的把C++ Point类导出为库、避开名称修饰，以及生成CPoint*风格C接口、再包装成仅头文件C++代码的需求，SWIG都能完美支持，下面给你详细拆解：

1. 生成CPoint*风格的C兼容接口 #

SWIG天生就擅长把C类转换成C语言能调用的接口，它会自动生成不透明指针（比如CPoint*）来指代原始的C Point对象，同时生成一系列C风格的函数来封装类的构造、成员调用和析构逻辑。

比如针对你的Point类，SWIG会生成类似这样的C函数：

// 创建Point对象的C风格构造函数
CPoint* new_Point(int x, int y);
// 封装getX()成员函数
int Point_getX(CPoint* obj);
// 封装getY()成员函数
int Point_getY(CPoint* obj);
// 销毁对象的C风格析构函数
void delete_Point(CPoint* obj);

这些函数内部会调用原始C类的对应方法，而且都是标准C函数签名，完全避开了C的名称修饰问题，能安全地跨编译单元或跨语言调用。

2. 生成仅头文件的C++包装代码 #

SWIG不仅能生成C接口，还能帮你把这些C函数封装成仅头文件的C代码——甚至可以直接生成和原始类接口几乎一致的C包装类，让你在其他C++代码里用更友好的方式调用。

举个简单的配置示例：
假设你有原始的point.h：

class Point {
public:
    Point(int x, int y);
    int getX();
    int getY();
};

写一个SWIG接口文件point.i，通过%inline指令直接定义仅头文件的C++包装：

%module point
%{
#include "point.h"
%}

%inline %{
// 这个包装类会被SWIG直接写入生成的头文件，无需额外源文件
class CPoint {
private:
    Point* m_impl;
public:
    CPoint(int x, int y) : m_impl(new Point(x, y)) {}
    int getX() { return m_impl->getX(); }
    int getY() { return m_impl->getY(); }
    ~CPoint() { delete m_impl; }
};
%}

运行SWIG命令：

swig -c++ -c point.i

生成的头文件里就会包含这个CPoint类，完全是仅头文件的C包装，内部自动衔接之前生成的C接口（或者直接调用原始C类，看你配置）。

额外实用技巧 #

• 你可以用%rename指令自定义生成的C函数名称，比如把new_Point改成create_point，让接口更符合你的命名习惯。
• 如果你的核心目标是导出C类为库供其他C/C项目调用，SWIG生成的C接口是绝佳的中间层——既解决了名称修饰的兼容性问题，又完整保留了原始类的功能。

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