Setuptools添加的runtime路径未生效，模块无法链接共享库求助

问题根源 #

你当前硬编码了conda环境的绝对路径作为rpath，这不仅不兼容非conda环境，还会因为用户Python版本、安装路径差异导致rpath失效。此外，链接器的rpath参数写法可能存在转义问题，导致$ORIGIN这类动态路径未被正确解析。

可行解决方案 #

1. 使用$ORIGIN设置动态相对rpath（推荐）

$ORIGIN是链接器支持的特殊变量，表示当前扩展模块所在的目录。通过它可以构建相对路径，适配任意安装位置：

修改Extension的extra_link_args：

super().__init__(
    name,
    sources=[],
    # 假设共享库在site-packages/lib，模块在site-packages/DEME，所以用../lib定位
    extra_link_args=['-Wl,-rpath,$ORIGIN/../lib'],
    libraries=["libDEMERuntimeDataHelper"],
    include_dirs=["./src/DEM/", "./src/DEM/VariableTypes"],
    extra_objects=["./build/libDEMERuntimeDataHelper.so"]  # 确保此处是具体的库文件路径
)

验证rpath是否生效：安装后，用以下命令检查扩展模块的rpath：

objdump -x $(python -c "import DEME; print(DEME.__file__)") | grep RPATH

输出应包含$ORIGIN/../lib。

2. 将共享库与模块放在同一目录

把共享库安装到Python模块的子目录（比如DEME/lib），这样rpath设置更简单，也更不容易出错：

• 在setup.py中配置package_data，确保共享库被复制到模块目录：

from setuptools import setup, Extension

setup(
    name="DEME",
    packages=["DEME"],
    # 假设共享库放在项目的DEME/lib目录下
    package_data={"DEME": ["lib/*.so"]},
    ext_modules=[
        Extension(
            "DEME._DEME",  # 扩展模块作为子模块存在
            sources=[...],
            extra_link_args=['-Wl,-rpath,$ORIGIN/lib'],
            libraries=["libDEMERuntimeDataHelper"],
            include_dirs=["./src/DEM/", "./src/DEM/VariableTypes"],
            extra_objects=["./build/libDEMERuntimeDataHelper.so"]
        )
    ]
)

3. 在Python模块初始化时动态设置库路径

如果上述链接器方案无法生效，可以在模块的__init__.py中动态修改LD_LIBRARY_PATH，确保导入扩展前路径已被添加：

import os
from pathlib import Path

# 获取模块所在目录
module_dir = Path(__file__).parent
# 共享库所在目录，根据实际安装位置调整
lib_dir = module_dir.parent / "lib"

# 更新LD_LIBRARY_PATH
if "LD_LIBRARY_PATH" in os.environ:
    os.environ["LD_LIBRARY_PATH"] = f"{lib_dir}:{os.environ['LD_LIBRARY_PATH']}"
else:
    os.environ["LD_LIBRARY_PATH"] = str(lib_dir)

# 导入实际的C++扩展模块
from ._DEME import *

4. 检查共享库的安装路径

确保构建脚本将共享库正确复制到site-packages/lib目录。可以在setup.py中添加data_files配置：

setup(
    ...
    data_files=[
        ("lib", ["./build/libDEMERuntimeDataHelper.so"])
    ],
    ...
)

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