在使用 swig 封装 opencv c++ api 时，直接 `%include "opencv2/core/core.hpp"` 会因头文件依赖缺失导致“syntax error - possibly a missing semicolon”编译错误；根本原因是 swig 无法自动解析 `core.hpp` 内部隐式包含的 `types_c.h` 和 `version.hpp`，需显式前置引入。
SWIG 是一个面向 C/C++ 的接口生成器，但它不具备 C++ 预处理器的完整解析能力，尤其不支持自动递归处理 #include 指令。当您在 SWIG 接口文件中写入：
%include "opencv2/core/core.hpp"
SWIG 会尝试直接解析该头文件内容，但 core.hpp 开头即包含：
#include "opencv2/core/types_c.h" #include "opencv2/core/version.hpp"
而这两个被引用的头文件并未被 SWIG 加载——其类型定义（如 CV_EXPORTS, CV_INLINE, 宏常量、C 风格结构体等）缺失，导致 SWIG 在解析后续代码（例如函数声明或模板特化）时遇到未定义符号或意外语法结构，最终报出类似第 123 行“缺少分号”的误导性错误。
✅ 正确做法是显式、按依赖顺序引入所有必需的底层头文件。OpenCV 2.4.x 的 core.hpp 主要依赖以下两个基础头：
ImageMagick 批处理处理器
下载
使用 ImageMagick 的 convert 和 mogrify 命令进行批量图像处理，支持调整大小、裁剪、水印和格式转换。与 libvips 集成以实现高性能缩略图生成。
- opencv2/core/version.hpp：定义 OpenCV 版本宏（如 CV_VERSION_MAJOR），影响条件编译分支；
- opencv2/core/types_c.h：提供核心 C 类型（CvPoint, CvSize, IplImage* 等）及基础宏（CV_EXPORTS），是 core.hpp 中多数 C++ 类（如 cv::Mat）声明的前提。
因此，您的 .i 接口文件应改为：
%module example
%{
#include "opencv2/core/core.hpp"
%}
// 按依赖顺序显式引入（关键！）
%include "opencv2/core/version.hpp"
%include "opencv2/core/types_c.h"
%include "opencv2/core/core.hpp"⚠️ 注意事项：
- 顺序不可颠倒：version.hpp 和 types_c.h 必须在 core.hpp 之前 %include，否则依赖关系仍不满足；
- 不要仅 %include 对应的 .h 而忽略 .hpp —— OpenCV 的 C++ API 主体在 core.hpp，C 接口在 types_c.h，二者需协同；
- 若后续扩展使用 imgproc 或 highgui，同样需先引入其依赖的 core 相关头文件；
- 对于 OpenCV 3.x/4.x，路径和模块结构略有变化（如 opencv2/core.hpp 变为顶层头），但“显式声明依赖头”的原则完全一致；
- 如遇更深层错误（如模板解析失败），可考虑启用 SWIG 的 -c++ 模式并添加 %template 显式实例化常用模板类（如 std::vector<:point>）。
通过显式管理头文件依赖，即可绕过 SWIG 的预处理局限，稳定生成可用的 Python/Java/其他语言绑定。
