如何用SWIG封装含int与int vector的C++ map到Python并正常取值

嘿，我刚好碰到过类似的问题，这其实是SWIG对嵌套模板容器的处理需要显式配置导致的——你用std::map<int, int>没问题是因为SWIG默认对简单的基础类型映射处理得比较好，但嵌套的std::vector<int>需要咱们手动告诉SWIG怎么包装它。咱们一步步来解决：

1. 修改你的SWIG接口文件（.i） #

这是最关键的一步，你需要在接口文件里显式实例化std::vector<int>和对应的std::map类型，让SWIG知道该生成对应的Python包装代码。示例如下：

%module your_module_name  // 替换成你的模块名

// 引入SWIG自带的标准容器处理接口
%include <std_vector.i>
%include <std_map.i>

// 显式实例化std::vector<int>，给它起个Python里能用的名字IntVector
%template(IntVector) std::vector<int>;

// 再实例化嵌套的map类型，同样起个清晰的名字
%template(IntToIntVectorMap) std::map<int, std::vector<int>>;

// 最后引入你的C++头文件
%include "your_header_file.h"  // 替换成你的实际头文件名

2. 确认你的C++函数返回类型正确 #

确保你的C++函数确实返回的是std::map<int, std::vector<int>>，比如一个简单的测试函数：

#include <map>
#include <vector>

std::map<int, std::vector<int>> get_test_map() {
    std::map<int, std::vector<int>> result;
    result[1] = {10, 20, 30};
    result[2] = {40, 50, 60};
    return result;
}

3. 重新编译生成Python模块 #

按照SWIG的常规编译流程重新生成模块：

• 第一步生成包装代码：

  swig -python -c++ your_module_name.i
  

• 第二步编译C++源文件和包装代码（注意替换Python头文件路径，根据你的Python 3.7.3安装位置调整）：

  g++ -fPIC -c your_module_name_wrap.cxx your_source_file.cpp -I/usr/include/python3.7
  

• 第三步链接成共享库：

  g++ -shared your_module_name_wrap.o your_source_file.o -o _your_module_name.so
  

4. 在Python中正确访问值 #

现在你在Python里就能像操作普通字典和列表一样访问这个map了：

import your_module_name

my_map = your_module_name.get_test_map()
for key in my_map:
    print(f"键：{key}")
    # 现在值会被包装成类似Python列表的对象，可以直接转成列表查看
    values_list = list(my_map[key])
    print(f"对应的值：{values_list}")

为什么之前会显示SWIG对象？ #

因为SWIG默认不会自动处理嵌套的模板容器，当你返回std::map<int, std::vector<int>>时，SWIG不知道该怎么把std::vector<int>转换成Python可识别的类型，只能返回底层的SWIG包装对象。而显式实例化模板后，SWIG会为std::vector<int>生成对应的Python接口，让map的值可以被正确解析成可操作的列表。

另外提个小注意：你的SWIG版本3.0.12虽然不算最新，但处理这种嵌套容器是完全没问题的，如果后续遇到其他模板相关问题，可以考虑升级到最新稳定版，但当前场景下这个方案足够解决问题。

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