Python/C++扩展链接GLFW库时未定义符号错误的解决问询

问题根源分析 #

你的问题核心在于setup.py中GLFW库的路径配置错误，以及运行时动态库的查找路径未正确设置：

1. 编译后的GLFW共享库位于lib/glfw/src目录，但你之前的library_dirs指向了lib/glfw，导致链接器找不到库文件；
2. 即使链接成功，安装后的扩展模块无法定位GLFW动态库，导致运行时出现ImportError。

方案1：动态链接GLFW（推荐） #

修改setup.py，修正库路径并配置运行时查找路径：

from setuptools import setup, Extension

# 配置扩展模块
module1 = Extension('test',
                    sources=['main.cpp', 'src/glfw_binder.cpp'],
                    include_dirs=["include", "lib/glfw/include"],
                    # 修正为GLFW库实际所在目录
                    library_dirs=["lib/glfw/src"],
                    # 链接libglfw.so，只需写库名前缀（去掉lib和后缀）
                    libraries=['glfw'],
                    extra_link_args=[
                        # 设置运行时库查找路径：$ORIGIN表示当前模块所在目录，../lib/python_test是库安装路径
                        "-Wl,-rpath,$ORIGIN/../lib/python_test",
                        # 添加GLFW依赖的系统库
                        "-lGL", "-lGLU", "-lm"
                    ]
                    )

setup(
    name='python_test',
    version='1.0',
    description='This is a demo package',
    ext_modules=[module1],
    # 将GLFW动态库打包到安装目录，确保运行时能找到
    data_files=[
        ('lib/python_test', [
            'lib/glfw/src/libglfw.so',
            'lib/glfw/src/libglfw.so.3',
            'lib/glfw/src/libglfw.so.3.3'
        ])
    ]
)

关键修改说明： #

• library_dirs=["lib/glfw/src"]：指向编译后GLFW共享库的实际位置；
• libraries=['glfw']：链接器会自动查找libglfw.so，无需写完整文件名；
• extra_link_args中的-Wl,-rpath,...：告诉动态链接器在运行时从指定路径加载GLFW库；
• data_files：将GLFW的共享库复制到安装目录，与扩展模块的查找路径对应。

方案2：静态链接GLFW（无需处理动态库依赖） #

如果不想处理运行时动态库路径问题，可以选择静态链接GLFW，将库代码直接打包到扩展模块中：

步骤1：重新编译静态版GLFW #

进入lib/glfw目录，执行以下命令：

cmake -G "Unix Makefiles" -DBUILD_SHARED_LIBS=OFF
make

这会生成静态库libglfw.a在lib/glfw/src目录下。

步骤2：修改setup.py配置静态链接 #

from setuptools import setup, Extension

module1 = Extension('test',
                    sources=['main.cpp', 'src/glfw_binder.cpp'],
                    include_dirs=["include", "lib/glfw/include"],
                    library_dirs=["lib/glfw/src"],
                    # 静态链接需要包含GLFW及其所有依赖的系统库
                    libraries=['glfw', 'GL', 'GLU', 'm', 'X11', 'Xrandr', 'Xi', 'Xxf86vm', 'Xinerama', 'Xcursor', 'rt'],
                    # 可选：静态链接C++标准库（避免依赖系统版本）
                    extra_link_args=['-static-libgcc', '-static-libstdc++']
                    )

setup(
    name='python_test',
    version='1.0',
    description='This is a demo package',
    ext_modules=[module1]
)

优势： #

生成的扩展模块无需依赖外部GLFW动态库，运行时不会出现库找不到的问题。

验证步骤 #

1. 执行构建与安装：

python3 setup.py build
sudo python3 setup.py install

2. 运行测试代码test.py，确认GLFW窗口正常显示。

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