Nuitka编译可执行文件依赖virtualenv问题及解决方案咨询

问题原因 #

你遇到的问题是因为编译时未启用Nuitka的独立打包模式，导致生成的可执行文件硬编码了编译时venv的绝对路径；而_virtualenv模块是virtualenv内部的依赖，因venv激活后的环境变量被Nuitka误纳入依赖链，移动或重命名venv后路径失效引发错误。错误指向布尔值初始化行是因为隐式导入（venv环境注入的依赖）在脚本执行前失败，Python错误栈会显示脚本第一行而非实际导入语句。

理想方案：将所有库打包进可执行文件 #

使用Nuitka的--standalone参数启用独立打包模式，配合--onefile可生成单个独立exe，彻底脱离venv依赖：

1. 确保已激活venv且安装了所有项目依赖
2. 执行编译命令：

python -m nuitka --standalone --onefile --output-file=run src/__main__.py

• --standalone：生成不依赖系统Python环境的独立包
• --onefile：将所有依赖打包为单个exe文件（若不需要单文件，可去掉此参数，生成包含exe和依赖的文件夹）
• 若存在Nuitka未自动检测到的依赖，可添加--include-package=包名参数强制包含，例如--include-package=requests

编译完成后，生成的run.exe可直接在其他电脑运行，无需携带venv文件夹。

备选方案：以相对路径查找venv文件夹 #

若无法完全脱离venv，可通过指定相对Python路径让exe从当前目录的venv加载依赖：

1. 编译前激活venv，执行以下命令（根据你的Python版本调整路径）：

• Windows系统：

python -m nuitka --follow-imports --python-path=./venv/Lib/site-packages --output-file=run src/__main__.py

• Linux/macOS系统：

python -m nuitka --follow-imports --python-path=./venv/lib/python3.10/site-packages --output-file=run src/__main__.py

2. 运行exe时，确保venv文件夹与run.exe处于同一目录，exe会通过相对路径加载venv内的依赖

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