本文详解如何用 swig 正确封装含智能指针、stl 容器的 c++ 类到 go，涵盖模块声明、文件扩展名规范、符号忽略策略及常见编译错误规避方法。
本文详解如何用 swig 正确封装含智能指针、stl 容器的
c++
类到 go，涵盖模块声明、文件扩展名规范、符号忽略策略及常见编译错误规避方法。
SWIG 是一款强大的接口生成工具，支持将 C/C++ 代码安全暴露给多种高级语言（包括 Go）。但在封装现代 C++（如使用 std::unique_ptr、std::shared_ptr、std::vector、std::string）时，若配置不当，极易因类型不识别或符号冲突导致编译失败——正如问题中 CreateCounters(vector>*) 引发的错误：SWIG 默认不支持 std::unique_ptr 等模板特化类型，且未显式声明模块名与启用 C++ 模式时，会直接跳过 STL 类型映射逻辑，进而报错。
✅ 正确配置 SWIG 接口文件（.swigcxx）
首先，
文件扩展名必须为 .swigcxx
（而非 .swig 或 .i），这是 SWIG 识别 C++ 模式的关键。其次，
必须声明 %module
——它不仅定义 Go 包名（生成的 Go 文件将位于同名包下），还触发 C++ 运行时支持（如 STL、智能指针的默认映射规则）。
修正后的 builder.swigcxx 示例：
? 提示：CreateCounters 参数含 vector>*，该类型 SWIG 无原生绑定，强行包含会导致解析失败。正确做法是
%ignore 彻底排除
，而非寄望于自动转换。
C知道
CSDN推出的一款AI技术问答工具
下载
立即学习
“
C++免费学习笔记（深入）
”；
? 编译流程（Go + SWIG）
确保已安装
SWIG 4.0+
和 Go 工具链：
? 注意事项与最佳实践
避免裸指针传递
：CreateEntry(string* primary_key) 在 Go 中将映射为 *C.char，需手动管理内存。更安全的做法是改用 const std::string& 或 std::string 值传递，并配合 %apply 规则（如 %apply const std::string& { std::string* };）提升 Go 友好性。
STL 类型需显式启用
：std_string.i 和 std_vector.i 必须 #include，且对 vector 需额外 %template 实例化（如 %template(IntVector) std::vector;），但本例中因已忽略相关函数，可省略。
构造函数签名需完整匹配
：%unignore Builder::Builder(int) 比仅写 %unignore Builder 更稳妥，防止重载构造函数干扰。
错误定位技巧
：若仍报错，运行 swig -cgo -go -debug-tmsearch builder.swigcxx 查看类型匹配日志，快速识别未映射的 C++ 类型。
✅ 总结
成功封装 C++ 到 Go 的核心在于三点：
① 使用 .swigcxx 扩展名激活 C++ 模式；
② 声明 %module 启动模块化绑定与 STL 支持；
③ 主动 ignore 所有 SWIG 不支持的现代 C++ 类型（如 unique_ptr、自定义模板），聚焦于 Go 可用接口。
遵循此范式，即可稳定生成类型安全、内存可控的 Go 绑定代码。
%module builder
%{
#include "builder.h"
%}
// 启用 C++11+ 支持（推荐显式添加）
%cpp11
// 忽略全部符号，再选择性解忽略
%ignoreall
// 仅暴露 Builder 类及其目标成员
%unignore Builder;
%unignore Builder::Builder(int); // 显式解忽略构造函数（含参数）
%unignore Builder::Init();
%unignore Builder::CreateEntry(std::string*); // 注意：C++ string → std::string*
// ⚠️ 关键：彻底忽略含 unsupported 类型的函数（如 unique_ptr）
%ignore Builder::CreateCounters;
%include "std_string.i" // 提供 std::string 支持
%include "std_vector.i" // 提供 std::vector 支持（但需手动实例化）
%include "builder.h"
%unignoreall # 1. 生成 Go 绑定代码（-cgo 启用 CGO）
swig -cgo -go -intgosize 64 -cgo-cflags "-I." -cgo-ldflags "-L." builder.swigcxx
# 2. 编译 C++ 实现（假设 builder.cpp 存在）
g++ -fPIC -c -std=c++11 builder.cpp -o builder.o
# 3. 构建共享库（Linux/macOS）
gcc -shared -o builder.so builder.o -lstdc++
# 4. 编译 Go 程序（需 import "./builder"）
go build -o main main.go