SWIG生成C++多语言接口的核心是编写接口文件（.i），通过解析C++头文件生成目标语言胶水代码，兼容主流编译器及Python/Java/Node.js/Go等语言，需重点处理类型映射、内存管理与异常转换。

用 SWIG 生成 C++ 多语言接口，核心是写好接口文件（.i），让 SWIG 解析 C++ 头文件并生成目标语言的胶水代码。整个过程不依赖 C++11 以上特性，兼容主流编译器和 Python/Java/Go/Node.js 等语言，关键是把类型映射、内存管理、异常转换这些细节理清楚。

一、准备 C++ 代码与 SWIG 接口文件

先确保你的 C++ 类或函数有清晰的头文件（如 math_utils.h）：

// math_utils.h
double add(double a, double b);
int factorial(int n);

然后写 SWIG 接口文件 math_utils.i：

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

注意：%{ %} 块里的内容会原样插入生成的包装代码中；%include 让 SWIG 解析头文件——它不预处理宏，所以避免在头文件里用未定义宏或模板声明。

立即学习“C++免费学习笔记（深入）”；

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

二、生成 Python 绑定（最常用）

命令行执行（以 Python 3.9 为例）：

swig -c++ -python math_utils.i
g++ -fPIC -shared math_utils_wrap.cxx math_utils.cpp -I/usr/include/python3.9 -lpython3.9 -o _math_utils.so

关键点：

• -c++ 表示输入是 C++ 代码
• 生成的 math_utils.py 是纯 Python 模块，_math_utils.so 是动态库，必须同目录
• 路径和 Python 版本要严格匹配，可用 python3-config --includes 和 --ldflags 获取准确参数

三、支持 Java / Node.js / Go（简配方案）

SWIG 对不同语言的支持程度不同，但基础流程一致：

• Java：加 -java 参数，生成 .java + .cxx，用 javac 编译 Java，g++ 编译动态库，再用 System.loadLibrary 加载
• Node.js：用 -node，生成 .js + .cxx，需配合 node-gyp 构建，注意 v8 API 版本兼容性
• Go：SWIG 官方支持有限，推荐用 -go 生成 .go + .h + .c，再通过 cgo 调用，C++ 类需封装为 C 风格接口（extern "C"）

所有语言都默认不支持 STL 容器、智能指针、重载函数——需要手动添加 typemaps 或用 SWIG 的 %template、%shared_ptr 等指令扩展。

四、处理常见问题

实际绑定时容易卡在这几个地方：

• C++ 异常没转成目标语言异常：在 .i 文件开头加 %exception 块，捕获 std::exception 并转成 Python Exception 或 Java RuntimeException
• std::string / std::vector 无法自动识别：包含 SWIG 内置库，例如 %include "std_string.i"、%include "std_vector.i"
• 类成员函数调用崩溃：检查是否忘了 %include "std_shared_ptr.i"，或对象生命周期没管理好（尤其返回裸指针时）
• Python 导入报 undefined symbol：确认 g++ 编译时链接了所有依赖库（比如 -lstdc++），且没有遗漏 -fPIC