Python C++扩展导入报符号未找到错误，如何分文件定义函数？

问题根源 #

错误核心是**static关键字的作用域限制**：在C/C++中，static修饰的函数仅对当前编译单元（单个.cpp文件）可见。你的代码里，lib1.cpp和lib2.cpp中的func1、func2被声明为static，意味着它们只能在各自的.cpp文件内部被访问；而module.cpp中虽然包含了头文件，但头文件里的static声明会让module.cpp生成一份自己的func1、func2空副本，链接时找不到实际定义，从而抛出符号缺失错误。

解决方法 #

方案1：移除static关键字，使用外部链接 #

这是最直接的解决方式，让函数在整个扩展模块的编译单元中可见：

1. 修改tech.h，将static替换为extern，声明函数为外部可见：

// tech.h
extern PyObject *func1(PyObject *self, PyObject *args);
extern PyObject *func2(PyObject *self, PyObject *args);

2. 修改lib1.cpp和lib2.cpp，移除函数定义前的static：

// lib1.cpp
#include "tech.h"
PyObject *func1(PyObject *self, PyObject *args) {
    // 函数实现
}

// lib2.cpp
#include "tech.h"
PyObject *func2(PyObject *self, PyObject *args) {
    // 函数实现
}

3. module.cpp保持不变，依旧包含tech.h即可，此时methods数组能正确找到func1和func2的符号。

方案2：使用C++匿名命名空间替代static（推荐，兼顾封装性） #

如果你不想让函数暴露给扩展模块以外的代码，可以用C++的匿名命名空间替代static，它的作用域覆盖整个链接后的编译单元（所有参与编译的.cpp文件），但不会污染全局符号表：

1. 修改tech.h，去掉static，用extern声明函数：

// tech.h
extern PyObject *func1(PyObject *self, PyObject *args);
extern PyObject *func2(PyObject *self, PyObject *args);

2. 在lib1.cpp和lib2.cpp中，将函数放在匿名命名空间内：

// lib1.cpp
#include "tech.h"
namespace {
PyObject *func1(PyObject *self, PyObject *args) {
    // 函数实现
}
} // 匿名命名空间结束

// 显式导出符号，让module.cpp能访问
extern "C" PyObject *func1(PyObject *self, PyObject *args) {
    return ::func1(self, args);
}

// lib2.cpp
#include "tech.h"
namespace {
PyObject *func2(PyObject *self, PyObject *args) {
    // 函数实现
}
} // 匿名命名空间结束

extern "C" PyObject *func2(PyObject *self, PyObject *args) {
    return ::func2(self, args);
}

注：这里用extern "C"是为了保证符号名称不被C++编译器篡改，和Python的C API兼容。

验证修改 #

修改完成后，重新运行python setup.py build或pip install .，扩展模块就能正常加载，且函数可以分文件存放。

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