PyInstaller打包程序后如何创建并调用持久化venv虚拟环境

可行性结论 #

该需求完全可实现，无需目标机器预装原生Python。核心思路是随分发包携带完整的官方Python嵌入式发行版作为venv的底层运行时，不要直接使用PyInstaller生成的冻结运行时创建venv——PyInstaller打包出的运行时是裁剪后的隔离环境，不满足venv创建要求的完整解释器结构、标准库链路，这也是此前两种测试方案失败的根本原因。

此前方案失败的核心原因 #

• 直接调用venv.EnvBuilder/venv.create失败：PyInstaller冻结环境缺失独立的python.exe可执行文件、完整标准库源文件、ensurepip依赖的完整wheel资源，创建出的venv结构残缺。Windows平台venv对应的可执行目录为Scripts（Linux/macOS下为bin），该目录未生成完整的解释器、pip软链路/副本时，pip安装包实际会写入PyInstaller运行时的临时解压目录，不会存入指定的venv路径，应用重启后安装的包直接丢失。
• subprocess调用系统Python命令创建venv失败：该逻辑本身依赖目标机器预装Python，违反核心约束；with_pip=True参数运行失败的原因是冻结环境内没有可独立调度的Python解释器进程，ensurepip无法找到可挂载的运行时完成初始化。

可落地实现步骤 #

• 第一步：准备嵌入式Python资源
  下载和开发环境大、小版本完全一致的Windows Python嵌入式发行版（Embeddable Package），作为资源文件打包进PyInstaller分发包。修改压缩包内的python3xx._pth文件（xx对应版本号，比如3.11版本为python311._pth），注释掉import site行，解除嵌入式包默认的路径隔离限制，保证后续可以正常创建venv、安装第三方包。
• 第二步：首次启动初始化持久化venv
  应用首次启动时先检测持久化路径下的venv是否存在，不存在则先解压内置的嵌入式Python包到程序私有目录，调用该嵌入式Python的可执行文件创建venv，全程不依赖系统Python。参考逻辑如下：

  import subprocess
  import os
  from pathlib import Path
  
  # 持久化venv存放路径，优先选择用户目录下的AppData，规避系统目录权限问题
  VENV_PATH = Path(os.getenv("APPDATA")) / "your_app_identify" / "runtime_venv"
  # 解压后的内置嵌入式Python解释器路径
  EMBEDDED_PYTHON = Path(__file__).parent / "embedded_runtime" / "python.exe"
  
  def init_persist_venv():
      if not VENV_PATH.exists():
          # 调用内置解释器创建venv
          subprocess.run(
              [str(EMBEDDED_PYTHON), "-m", "venv", str(VENV_PATH)],
              check=True,
              capture_output=True
          )
          # 初始化后升级pip，避免后续装包出现版本兼容问题
          subprocess.run(
              [str(VENV_PATH / "Scripts" / "python.exe"), "-m", "pip", "install", "--upgrade", "pip"],
              check=True,
              capture_output=True
          )
  

• 第三步：启动时加载venv环境
  给程序加一层薄引导逻辑：每次启动先执行venv初始化检测，之后要么将venv的Lib/site-packages路径注入到Python进程的sys.path最前端再加载主业务逻辑；要么直接调用venv下的Scripts/python.exe启动打包在资源内的主业务脚本，后续所有用户安装的第三方包都会存入venv的site-packages目录，启动时自动加载。
• 第四步（可选）：内置包管理入口
  如果需要降低用户安装第三方包的门槛，可以直接在应用内封装操作入口，调用venv下的解释器执行pip命令，不需要用户手动打开终端操作。

注意事项 #

• 内置的嵌入式Python版本必须和开发、打包用的Python版本完全一致，否则会出现ABI兼容问题，导致部分C扩展类第三方库运行报错。
• 持久化venv不要存放在Program Files等需要管理员权限的系统目录，否则普通用户安装第三方包时会因为权限不足失败。
• 不要尝试直接用PyInstaller生成的冻结解释器创建venv，该运行时是为单文件应用运行设计的裁剪环境，不具备作为venv基础解释器的完整能力。

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