如何在构建阶段设置CDLL搜索路径？——解决Python加载非标准路径libcustom.so的问题

这个问题我太熟了，之前做Python绑定C扩展库的时候踩过不少类似的坑，给你几个不用依赖全局LD_LIBRARY_PATH的解决方案，都是在构建或代码层面搞定的：

这是最直接的办法，不用折腾系统层面的设置。如果你的libcustom.so和Python包的目录固定，可以动态拼接路径，避免硬编码：

import os
from ctypes import cdll
from importlib.resources import files

# 假设libcustom.so和mypackage包在同一目录下
lib_dir = files("mypackage").resolve()
lib_path = os.path.join(lib_dir, "libcustom.so")
lib = cdll.LoadLibrary(lib_path)

如果共享库的路径是固定的绝对路径，直接写死也没问题，比如cdll.LoadLibrary("/opt/my/libs/libcustom.so")。

这就是你想要的类似rpath的机制，直接把查找路径嵌入到libcustom.so里，这样不管哪个程序加载它，都会自动去指定目录找依赖（包括Python的ctypes）。

如果是自己编译libcustom.so，编译时直接加上rpath参数：

gcc -shared -fPIC -Wl,-rpath=/path/to/custom/lib -o libcustom.so your_source_code.c

如果已经编译好共享库了，可以用patchelf工具修改（大部分Linux发行版都能通过包管理器安装）：

patchelf --set-rpath /path/to/custom/lib libcustom.so

这样设置后，直接运行python3 -c "import mypackage"就能正常加载，完全不用管环境变量。

这个方法不会影响全局环境，只对当前Python进程生效，适合需要动态切换库路径的场景：

import os
from ctypes import cdll
from ctypes.util import find_library

# 把目标路径加到当前进程的LD_LIBRARY_PATH开头
custom_lib_path = "/path/to/custom/lib"
os.environ["LD_LIBRARY_PATH"] = f"{custom_lib_path}:{os.environ.get('LD_LIBRARY_PATH', '')}"

# 用find_library自动查找libcustom.so
lib_name = find_library("custom")
if not lib_name:
    raise RuntimeError("Failed to locate libcustom.so")
lib = cdll.LoadLibrary(lib_name)

这里的关键是，环境变量的修改只会影响当前Python进程，不会污染系统全局或者其他进程。

如果你只想让特定的Python解释器能找到这个库，可以给Python二进制文件添加rpath，但这个方法会影响该解释器运行的所有程序，容易引发依赖冲突，谨慎使用：

patchelf --add-rpath /path/to/custom/lib $(which python3)

内容的提问来源于stack exchange，提问作者Bala­tous