如何实现将Python依赖库及自定义程序嵌入单文件可执行程序？

你的需求完全可行，问题核心在于单文件模式下PyInstaller对资源的解压逻辑和路径获取方式，以及参数的正确用法。以下是具体解决步骤：

1. 正确配置PyInstaller打包参数 #

单文件模式下，PyInstaller会将所有资源解压到系统临时目录，因此--add-data/--add-binary的参数格式必须区分操作系统：

• Windows平台：用分号;分隔源路径和目标路径
• Linux/macOS平台：用冒号:分隔源路径和目标路径

示例打包命令：

# Windows环境
pyinstaller --onefile ^
  --add-data "user_deps;user_deps" ^
  --add-binary "user_custom_app.exe;." ^
  --hidden-import user_deps.core ^
  your_main_script.py

# Linux/macOS环境
pyinstaller --onefile \
  --add-data "user_deps:user_deps" \
  --add-binary "user_custom_app:." \
  --hidden-import user_deps.core \
  your_main_script.py

说明：user_deps是用户依赖库的本地路径，打包后会被放到临时目录的user_deps子文件夹；自定义程序会直接放到临时目录根目录。

2. 代码中动态获取资源路径 #

单文件运行时，程序会被解压到sys._MEIPASS指向的临时目录，不能用固定本地路径。写一个工具函数统一处理路径：

import os
import sys

def get_resource_path(relative_path):
    try:
        # 单文件打包后的临时目录路径
        base_path = sys._MEIPASS
    except AttributeError:
        # 开发模式下的本地项目根目录
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

然后在代码中这样引用资源：

# 导入用户依赖库
import sys
deps_path = get_resource_path("user_deps")
sys.path.append(deps_path)
from user_deps.core import run_user_code

# 启动自定义程序
import subprocess
app_path = get_resource_path("user_custom_app.exe")
subprocess.Popen([app_path], shell=True)

3. 解决--hidden-import不生效问题 #

如果依赖库是动态导入（比如用importlib），PyInstaller自动检测不到，除了加--hidden-import，还可以用hook文件强制导入：

1. 创建hook-user_deps.py文件，内容如下：

from PyInstaller.utils.hooks import collect_submodules
hiddenimports = collect_submodules('user_deps')

2. 打包时加上--additional-hooks-dir .参数，让PyInstaller加载这个hook文件。

4. 用spec文件手动控制打包（可选） #

如果命令行参数不好调试，可以直接修改PyInstaller生成的.spec文件，手动配置datas和binaries列表：

# your_main_script.spec
a = Analysis(
    ['your_main_script.py'],
    datas=[('user_deps', 'user_deps'), ('user_custom_app.exe', '.')],
    binaries=[],
    hiddenimports=['user_deps.core'],
    # 其他配置...
)
# 后续打包直接运行：pyinstaller your_main_script.spec

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