SWIG是一个支持多语言的C/C++接口生成工具，通过编写.i接口文件，可自动生成Python、Java、JavaScript等语言的绑定代码。首先定义模块并包含头文件，接着用swig命令生成包装代码，再将C++源码与包装代码编译为共享库，最终在目标语言中导入使用。它能处理复杂类型和异常，支持多种语言只需更换参数，极大简化跨语言调用流程。
在实际开发中，C++ 编写的高性能模块常常需要被 Python、Java、JavaScript 等高级语言调用。手动编写接口繁琐且容易出错，SWIG（Simplified Wrapper and Interface Generator）是一个强大的工具，可以自动为 C++ 代码生成多种目标语言的绑定接口，实现跨语言调用。
什么是 SWIG
SWIG 是一个开源的编译器，用于连接 C/C++ 代码与多种脚本语言。它读取 C/C++ 头文件或接口文件（.i 文件），自动生成目标语言所需的胶水代码。支持的语言包括 Python、Java、Lua、Ruby、PHP、JavaScript（Node.js）、Go 等。
使用 SWIG 的核心是编写一个接口定义文件（通常以 .i 结尾），声明哪些函数、类、变量需要导出，并配置类型映射和包装行为。
基本使用流程
以 Python 调用 C++ 函数为例，展示如何使用 SWIG 实现跨语言调用。
立即学习“C++免费学习笔记（深入）”；
1. 编写 C++ 代码
假设有一个简单的 C++ 类：
example.h
class Calculator {
public:
Calculator();
int add(int a, int b);
double divide(double a, double b);
};
example.cpp
#include "example.h"Calculator::Calculator() {}
int Calculator::add(int a, int b) { return a + b; }
double Calculator::divide(double a, double b) { if (b == 0) throw "Division by zero!"; return a / b; }
2. 编写 SWIG 接口文件
example.i
%module example
%{
#include "example.h"
%}
%include "example.h"
其中 %module 定义模块名，%{ %} 中的内容会被原样插入到生成的包装代码中，%include 告诉 SWIG 需要包装的头文件。
3. 生成包装代码
运行 SWIG 命令：
swig -c++ -python example.i
这会生成两个文件：example_wrap.cxx 和 example.py。
4. 编译共享库
将原始 C++ 代码和生成的包装代码一起编译成 Python 可导入的模块：
g++ -fPIC -c example.cpp example_wrap.cxx -I/usr/include/python3.x g++ -shared example.o example_wrap.o -o _example.so
注意替换 Python 头文件路径，最终生成的 _example.so 是底层模块，而 example.py 是 Python 导入时使用的接口。
5. 在 Python 中使用
现在可以在 Python 中直接调用 C++ 功能：
import example calc = example.Calculator() print(calc.add(3, 4)) # 输出 7 print(calc.divide(10, 2)) # 输出 5.0
处理复杂类型与异常
SWIG 提供了丰富的指令来处理指针、引用、STL 容器、异常等。
- 使用 %exception 捕获 C++ 异常并转换为目标语言异常。
- 使用 %include
支持 std::vector，并通过 typemaps 映射到 Python list。 - 对 const char* 或 std::string，SWIG 默认能正确处理字符串传递。
例如添加异常处理：
%exception {
try {
$action
} catch (const char* msg) {
SWIG_exception(SWIG_RuntimeError, msg);
}
}
支持其他语言
只需更换 SWIG 命令参数即可生成不同语言的绑定：
-
Java:
swig -c++ -java example.i，生成 JNI 包装代码。 -
Node.js: 使用
-javascript和 Node 扩展机制结合。 -
Lua:
swig -c++ -lua example.i，生成 Lua 可加载模块。
每种语言的编译方式略有不同，但流程一致：生成包装代码 → 编译为动态库 → 在目标语言中导入使用。
基本上就这些。SWIG 极大简化了 C++ 与多语言生态的集成，适合封装算法库、引擎模块或性能敏感组件。虽然现代替代方案如 pybind11 更受 Python 社区欢迎，但 SWIG 仍是跨语言支持最广的工具之一。关键在于理解其接口文件机制和类型映射规则。不复杂但容易忽略细节。
