Pyinstaller结合venv与Pyenv打包时Python库未找到问题求助

问题核心原因 #

这个错误本质是PyInstaller无法找到Python的共享库文件（如macOS上的libpython3.10.dylib）。即便你通过pyenv重新安装了带--enable-shared/--enable-framework参数的Python，仍未解决的可能原因包括：

• 旧虚拟环境未关联新安装的Python版本，仍指向无共享库的旧Python
• pyenv的环境变量未正确加载，系统未切换到新安装的Python版本
• macOS下框架模式安装的Python，其库文件路径不在PyInstaller默认搜索范围内

分步修复方法 #

1. 确认并切换到正确的pyenv Python版本 #

先检查当前pyenv管理的所有版本，确保目标版本已安装并设为当前使用版本：

# 查看所有pyenv管理的Python版本
pyenv versions
# 设置全局使用3.10.2版本（或在项目目录用local命令）
pyenv global 3.10.2
# 验证当前Python版本是否正确
python --version

输出需显示Python 3.10.2，否则需检查pyenv初始化是否正常。

2. 重新创建虚拟环境 #

原虚拟环境基于旧Python版本创建，需删除后用新Python重建：

# 删除旧虚拟环境
rm -rf venv
# 用新Python创建虚拟环境
python -m venv venv
# 激活虚拟环境（macOS/Linux）
source venv/bin/activate
# Windows系统执行：venv\Scripts\activate

3. 重新安装依赖与PyInstaller #

在激活的新虚拟环境中，重新安装项目依赖和PyInstaller：

pip install pyinstaller
# 若有依赖文件，执行以下命令安装
pip install -r requirements.txt

4. macOS框架模式额外处理 #

如果是macOS且使用--enable-framework参数安装的Python，需手动指定库路径给PyInstaller：

# 打包时指定Python框架的库路径
pyinstaller --paths ~/.pyenv/versions/3.10.2/Python.framework/Versions/3.10/lib/ your_script.py

5. 验证共享库存在性 #

在激活的虚拟环境中，检查Python共享库的路径与存在性：

# 输出Python库目录路径
python -c "import sysconfig; print(sysconfig.get_config_var('LIBDIR'))"

进入该目录，确认libpython3.10.dylib（macOS）或libpython3.10.so（Linux）存在。

额外排查项 #

• Linux系统需安装对应版本的Python开发包：

  sudo apt-get install python3.10-dev
  

• 检查pyenv初始化配置：确保~/.bashrc或~/.zshrc中包含以下内容，若没有则添加后重启终端：

  export PATH="$HOME/.pyenv/bin:$PATH"
  eval "$(pyenv init --path)"
  eval "$(pyenv init -)"
  

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