macOS下编译简单SWIG-Python库及导入段错误问题排查

核心问题点 #

• 头文件防护宏命名冲突：你在Example.h中定义的防护宏是Example，和SWIG生成的模块名完全重名，会导致编译期符号被错误替换，是段错误的核心诱因之一。
• SWIG的std_vector未显式实例化：直接引入STL相关swig头后没有为std::vector<int>声明模板实例，SWIG不会自动生成对应类型的Python包装，运行时调用会触发内存访问异常。
• 编译步骤错误：编译C++代码时不需要把.h头文件作为编译输入，你执行的g++ -c Example.h Example.cpp会生成无效的预编译头文件，干扰后续链接流程。
• 导入方式错误：SWIG生成Python库后，应该导入自动生成的Example.py而非直接导入底层的_Example.so，直接导入底层库会跳过SWIG的初始化逻辑，直接触发段错误。
• 链接参数适配问题：macOS下编译Python扩展不需要显式链接libpython，Python解释器运行时会自动导出符号，显式链接反而会因为conda环境的符号冲突导致段错误。
• SWIG标准头引用错误：你在.i文件中引用的std_vector.h是错误的，SWIG官方STL包装头后缀为.i，正确名称是std_vector.i。

修复后的代码 #

Example.h #

// Example.h
#ifndef EXAMPLE_H // 改为全大写下划线格式，避免命名冲突
#define EXAMPLE_H

#include <vector>

std::vector<int> getVofI();

#endif

Example.i #

%module Example

%{
    #define SWIG_FILE_WITH_INIT
    #include <vector>
    #include "Example.h"
%}

%include "std_vector.i"
// 显式实例化int类型的vector模板，生成对应Python包装
%template(IntVector) std::vector<int>;
%include "Example.h"

Example.cpp无需修改，保持原有内容即可。

正确编译步骤 #

编译前请先删除目录下的*.gch预编译头文件，避免旧缓存干扰，同时确保已激活对应的py39 conda环境，CONDA_PREFIX环境变量会自动指向你的环境根目录，无需手动写绝对路径

# 1. 生成swig包装代码
swig -c++ -python Example.i

# 2. 编译C++源码，不要传入.h头文件
g++ -O2 -fPIC -std=c++17 -I${CONDA_PREFIX}/include/python3.9 -c Example.cpp
g++ -O2 -fPIC -std=c++17 -I${CONDA_PREFIX}/include/python3.9 -c Example_wrap.cxx

# 3. 链接生成动态库，去掉-lpython3.9参数
clang++ -std=c++17 -dynamiclib Example.o Example_wrap.o -o _Example.so

验证方式 #

import Example
vec = Example.getVofI()
print(vec) # 正常输出 [1, 2, 3]

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