PyInstaller打包为二进制后管理Python模块的正确方案问询

背景与现有实现 #

• 正在实现无需用户重装的软件远程补丁/更新方案，目标是发布新版本时无需重新打包executable，用户也无需重装。
• 当前采用PyInstaller编译的占位脚本导入.pyd格式的业务脚本，启动时检查更新，但该方案仅支持前端静态资源和后端逻辑更新；新增模块时仍需重新编译打包，要求用户重装——因为PyInstaller构建executable时必须包含所有必要模块。

待解决问题与核心诉求 #

希望通过服务器托管的requirements.txt，在启动时验证本地contents_directory是否已安装所有模块，并直接在编译后的二进制文件中调用pip完成模块的安装/卸载，且满足以下条件：

• 针对PyInstaller --onedir打包的executable，用户大概率未安装Python。
• 支持跨平台自动适配下载对应平台的二进制包（如Windows的.pyd、Linux的.so）。
• 能获取模块检查的回调，用于自定义LoadingWindow展示更新过程。

已尝试的无效思路 #

• 用subprocess调用python -m pip install：依赖用户系统已安装Python并配置PATH，不符合用户场景。
• 直接导入pip._internal：官方不推荐，存在兼容性风险。

可行解决方案 #

1. 打包时确保包含pip及相关依赖 #

PyInstaller默认不会自动打包pip、setuptools和wheel，需要通过参数强制包含，确保打包后的环境具备pip功能：

pyinstaller --onedir \
  --hidden-import pip \
  --hidden-import setuptools \
  --hidden-import wheel \
  your_entry_script.py

若使用spec文件，可在Analysis的hiddenimports中添加上述依赖：

a = Analysis(
    ['your_entry_script.py'],
    hiddenimports=['pip', 'setuptools', 'wheel'],
    # 其他配置...
)

2. 调用打包内置的Python解释器执行pip #

PyInstaller --onedir打包后，sys.executable会指向打包目录内的Python解释器（无需用户系统安装Python），通过subprocess调用该解释器执行pip命令：

import subprocess
import sys
import os

def install_modules(req_path, target_dir):
    # 获取打包内置的Python解释器路径
    python_exe = sys.executable
    # 构造pip安装命令
    cmd = [
        python_exe, '-m', 'pip', 'install',
        '-r', req_path,
        '--target', target_dir,
        '--upgrade'  # 可选：更新已有模块
    ]
    # 执行命令，可捕获输出用于回调
    result = subprocess.run(
        cmd,
        capture_output=True,
        text=True
    )
    # 返回执行结果，用于LoadingWindow更新状态
    return result.returncode, result.stdout, result.stderr

def uninstall_modules(module_name, target_dir):
    python_exe = sys.executable
    cmd = [
        python_exe, '-m', 'pip', 'uninstall',
        module_name,
        '--target', target_dir,
        '-y'
    ]
    result = subprocess.run(cmd, capture_output=True, text=True)
    return result.returncode, result.stdout, result.stderr

3. 模块检查与回调实现 #

使用importlib.metadata（Python 3.8+）检查目标目录下的模块是否满足requirements.txt的要求，将检查结果反馈给LoadingWindow：

from importlib.metadata import DistributionNotFound, version
import sys

def check_module(module_name, required_version=None, target_dir=None):
    # 将目标目录添加到临时sys.path，以便检查
    if target_dir:
        sys.path.insert(0, target_dir)
    try:
        current_version = version(module_name)
        # 若指定版本，验证是否符合要求（此处示例为>=，可根据需求调整）
        if required_version and current_version < required_version:
            return False, f"模块{module_name}版本不足：当前{current_version}，需要{required_version}"
        return True, f"模块{module_name}已满足要求：{current_version}"
    except DistributionNotFound:
        return False, f"模块{module_name}未安装"
    finally:
        # 移除临时添加的路径
        if target_dir and target_dir in sys.path:
            sys.path.remove(target_dir)

# 解析requirements.txt并批量检查
def check_requirements(req_path, target_dir):
    with open(req_path, 'r') as f:
        req_lines = [line.strip() for line in f if line.strip() and not line.startswith('#')]
    results = []
    for line in req_lines:
        # 拆分模块名和版本要求（简单处理，复杂版本规则需用packaging库）
        if '==' in line:
            module_name, required_version = line.split('==', 1)
            status, msg = check_module(module_name, required_version, target_dir)
        else:
            module_name = line.split('>', 1)[0].split('<', 1)[0].strip()
            status, msg = check_module(module_name, target_dir=target_dir)
        results.append((module_name, status, msg))
        # 此处可触发LoadingWindow的回调，实时更新检查状态
        # update_loading_window(f"检查模块：{module_name} - {msg}")
    return results

4. 整合更新流程 #

1. 启动时通过requests从服务器下载最新的requirements.txt和版本文件。
2. 调用check_requirements检查本地contents_directory的模块状态，同步更新LoadingWindow。
3. 对未满足要求的模块，调用install_modules执行安装。
4. 安装完成后再次验证模块状态，确认更新成功。

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