PyInstaller打包程序动态加载.whl插件及依赖的方案咨询

核心思路 #

让打包后的单文件夹应用自带独立的pip能力，无需依赖用户系统的Python环境，将插件及其依赖安装到应用专属的插件目录，再动态加载该目录下的模块。

具体步骤 #

1. 打包时嵌入pip及工具链 #

修改PyInstaller打包命令，确保将pip、setuptools、wheel打包进应用，同时保留必要的元数据：

pyinstaller --onedir --copy-metadata pip --copy-metadata setuptools --copy-metadata wheel --hidden-import pip._internal --hidden-import setuptools --hidden-import wheel your_main_script.py

此命令会让打包后的应用包含完整的pip功能，完全脱离用户系统的Python。

2. 实现内置pip的插件安装逻辑 #

在应用代码中添加安装函数，将插件及其依赖安装到应用目录下的plugins/site-packages子目录（跨平台路径自动适配）：

import sys
import os
from pip._internal import main as pip_main

# 定义插件安装目录，基于应用执行文件所在路径
PLUGIN_SITE_PACKAGES = os.path.join(os.path.dirname(sys.executable), "plugins", "site-packages")
os.makedirs(PLUGIN_SITE_PACKAGES, exist_ok=True)

# 将插件目录加入Python搜索路径，确保安装后的模块能被导入
sys.path.append(PLUGIN_SITE_PACKAGES)

def install_plugin(plugin_source):
    # 调用内置pip，将插件安装到指定目录
    pip_main(["install", "--target", PLUGIN_SITE_PACKAGES, plugin_source])

这里的sys.executable指向打包后的应用主程序（Windows下是.exe，Linux下是可执行文件），所以插件目录会创建在应用根目录下，无需用户额外权限。

3. 动态加载插件 #

安装完成后，使用标准的动态导入方式加载插件：

import importlib.util

def load_plugin(plugin_module_name):
    spec = importlib.util.find_spec(plugin_module_name)
    if not spec:
        raise ImportError(f"Plugin {plugin_module_name} not found")
    plugin_module = importlib.util.module_from_spec(spec)
    spec.loader.exec_module(plugin_module)
    return plugin_module

4. 自动处理插件依赖 #

如果你的插件通过setup.py声明了依赖，只需在调用install_plugin时传入插件的PyPI地址、本地源码路径或.whl文件路径，内置pip会自动解析并安装所有依赖到PLUGIN_SITE_PACKAGES，无需额外配置。

方案优势（解决你之前的问题） #

• 替代方案1：不再依赖用户系统的Python和pip，应用自身完成所有安装操作。
• 替代方案2：采用标准site-packages目录结构，Python能正常识别并导入插件及其依赖，避免egg目录的导入问题。

跨平台注意事项 #

• 始终使用os.path.join或pathlib处理路径，避免硬编码斜杠导致的跨平台问题。
• Linux下确保应用安装在用户有写入权限的目录（如用户主目录），不要安装到系统级目录（如/usr/bin）。
• Windows下无需管理员权限，因为插件目录位于应用自身目录内。

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