PyInstaller跨平台项目：如何将.so/.dll库文件放入子目录？

嘿，这个需求太合理了——一堆库文件堆在可执行文件旁边确实容易让人看花眼，用户找不到主程序也正常。我来给你详细讲讲怎么修改.spec文件，把那些.so/.dll（macOS上是.dylib）都挪到子目录里，而且不用走--one-file模式：

PyInstaller默认会把所有依赖的二进制库和可执行文件放在同一目录，我们需要修改.spec文件里的binaries配置，把这些库定向到子目录（比如叫libs/）。

在你的.spec文件里，找到Analysis模块的定义，在它之后添加一段代码，遍历所有收集到的二进制文件，修改它们的输出路径：

import os

# 原有的Analysis定义
a = Analysis(
    ['your_main_script.py'],
    pathex=[],
    binaries=[],
    datas=[],
    # ... 其他原有参数
)

# 把所有二进制库转移到libs子目录
a.binaries = [
    (os.path.join('libs', os.path.basename(src_path)), src_path, 'BINARY')
    for src_path, dest_path, file_type in a.binaries
]

这段代码会把所有.so/.dll/.dylib文件都放到打包后的libs/文件夹里，而可执行文件留在根目录。

库挪走后，程序启动时可能会找不到依赖，所以需要告诉系统去哪里加载这些库。不同平台的处理方式略有不同，我们可以写一个**运行时钩子（runtime hook）**来统一处理：

第一步：创建运行时钩子文件 #

新建一个set_lib_path.py文件，内容如下：

import os
import sys

def setup_library_path():
    # 获取程序的根目录（打包后会自动识别临时目录或安装目录）
    app_root = sys._MEIPASS if hasattr(sys, '_MEIPASS') else os.path.dirname(os.path.abspath(sys.argv[0]))
    # 拼接子目录路径
    lib_dir = os.path.join(app_root, 'libs')
    
    # 根据平台设置对应的环境变量
    if sys.platform == 'darwin':
        # macOS 平台
        os.environ['DYLD_LIBRARY_PATH'] = f"{lib_dir}:{os.environ.get('DYLD_LIBRARY_PATH', '')}"
    elif sys.platform.startswith('linux'):
        # GNU/Linux 平台
        os.environ['LD_LIBRARY_PATH'] = f"{lib_dir}:{os.environ.get('LD_LIBRARY_PATH', '')}"

setup_library_path()

第二步：把钩子加入.spec文件 #

回到你的.spec文件，修改Analysis的runtime_hooks参数，把刚才的钩子文件加进去：

a = Analysis(
    ['your_main_script.py'],
    pathex=[],
    binaries=[],
    datas=[],
    runtime_hooks=['set_lib_path.py'],  # 添加这一行
    # ... 其他原有参数
)

如果有个别库不需要放到子目录（比如某些系统级依赖，或者你程序里硬编码了路径的库），可以单独过滤出来：

# 定义不需要转移的库名单
excluded_libs = ['libsystem.so', 'some_special.dll']

a.binaries = [
    # 要转移到libs的库
    (os.path.join('libs', os.path.basename(src)), src, 'BINARY')
    for src, dest, typ in a.binaries
    if os.path.basename(src) not in excluded_libs
] + [
    # 保留在根目录的库
    (dest, src, typ)
    for src, dest, typ in a.binaries
    if os.path.basename(src) in excluded_libs
]

修改完.spec文件后，用命令重新打包：

pyinstaller your_script.spec

打包完成后，你会看到可执行文件乖乖待在根目录，所有的库文件都整齐地放在libs/子目录里，用户再也不会找不到主程序啦！

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