链接第三方库的pybind11扩展分发问题求助

方案一：直接修改setup.py添加链接参数 #

你的问题核心是setup.py未指定需要链接的第三方库，导致编译生成的扩展库没有关联libpng、GLEW等依赖，导入时出现未定义符号错误。

Pybind11Extension继承自setuptools的Extension类，支持与编译链接相关的参数，对应CMake的target_link_libraries、include_directories等功能：

• libraries: 指定需要链接的库名（去掉前缀lib和后缀.so/.a）
• include_dirs: 指定头文件搜索路径
• library_dirs: 指定库文件搜索路径
• extra_link_args: 额外的链接器参数（比如设置运行时库搜索路径rpath）

修改你的setup.py中ext_modules部分如下：

ext_modules = [
    Pybind11Extension("mylib",
        files,
        define_macros = [('VERSION_INFO', __version__)],
        # 头文件路径，根据实际情况调整，系统默认路径可省略
        include_dirs=["/usr/include/libpng", "/usr/include/GL"],
        # 库文件路径，根据实际情况调整，系统默认路径可省略
        library_dirs=["/usr/lib/x86_64-linux-gnu"],
        # 需要链接的第三方库名
        libraries=["png", "GLEW"],
        # 设置运行时库搜索路径，避免导入时找不到库
        extra_link_args=["-Wl,-rpath=/usr/lib/x86_64-linux-gnu"]
    ),
]

参数说明： #

• libraries=["png", "GLEW"]：对应链接系统中的libpng.so和libGLEW.so
• 若使用自定义编译的库，include_dirs和library_dirs需改为自定义路径（比如/usr/local/include、/usr/local/lib）
• extra_link_args通过-rpath告诉动态链接器运行时去哪里找依赖库，避免手动设置LD_LIBRARY_PATH

方案二：用scikit-build复用现有CMake配置 #

如果你已经有能正常构建的CMakeLists.txt，推荐用scikit-build，它允许直接基于CMake来构建Python扩展，无需在setup.py中重复管理依赖链接，更适合复杂项目：

1. 安装依赖：

pip install scikit-build cmake

2. 创建pyproject.toml文件，指定构建后端：

[build-system]
requires = ["setuptools", "scikit-build", "cmake", "pybind11"]
build-backend = "skbuild.setuptools_build_meta"

3. 简化setup.py：

from setuptools import setup

__version__ = "0.0.1"

setup(
    name="mylib",
    version=__version__,
    author="fab",
    author_email="fab@fab",
    description="mylib",
    python_requires=">=3.7",
)

4. 保留你原来的CMakeLists.txt（确保已正确链接libpng、GLEW等库），执行安装：

pip install .

scikit-build会自动调用CMake构建扩展，完全复用你已有的CMake配置，避免重复配置依赖。

验证方法 #

安装完成后，用以下命令检查扩展库的依赖是否正确链接：

ldd /home/fabrizio/.local/lib/python3.8/site-packages/mylib.cpython-38-x86_64-linux-gnu.so

如果输出中能看到libpng.so和libGLEW.so的路径，说明链接成功，此时再导入mylib应该正常。

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