如何通过SWIG将单个C函数暴露至Python接口？

正确的SWIG接口写法 #

你不需要在接口中引入整个test.c，只需要保留函数声明即可。以下是精简后的test.i：

%module test
%{
// 仅包含头文件，让包装代码获取函数声明
#include "test.h"
%}

// 按需导入类型支持（比如stdint相关）
%include "stdint.i"

// 暴露目标函数（直接包含头文件即可，因为test.h里只有testFunc的声明）
%include "test.h"

编译与链接的核心步骤 #

报错的根源是编译阶段没有正确链接test.c依赖的外部库，而非SWIG接口写法错误。按以下步骤操作：

1. 用SWIG生成Python包装代码：

   swig -python test.i
   

2. 编译C源文件和SWIG生成的包装代码，同时指定Python头文件路径：

   gcc -fPIC -c test.c test_wrap.c -I/usr/include/python3.10  # 替换为你的Python版本对应的头文件路径
   

3. 编译为共享库，链接所有test.c依赖的外部库：

   gcc -shared test.o test_wrap.o -o _test.so -L/path/to/your/libs -lsomeotherfunctions  # -L指定库路径，-l指定库名
   

   完成后，_test.so就能正常被Python导入，且只包含你需要的testFunc接口。

进一步精简依赖的技巧 #

如果test.c体积过大、依赖复杂，你可以：

• 把testFunc单独提取到一个独立的C文件（比如test_func.c），只保留必要代码：

  #include "test.h"
  int testFunc(int n, int m) {
      return n + m;
  }
  

  编译时用这个小文件替代原test.c，彻底规避其他不必要的依赖。
• 若无法提取函数，确保编译链接时引入所有test.c依赖的库文件即可，SWIG只负责生成接口，不处理编译依赖。

避坑提醒 #

• 绝对不要在SWIG接口中用%include test.c或在%{ ... %}块中包含test.c，这会把整个源文件插入到包装代码中，引入大量冗余符号和依赖，直接导致编译失败。
• SWIG只需要函数的声明来生成接口，函数的实现完全由编译阶段处理，接口中只需保留声明即可。

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