- Windows 10 或 11
- Python 3.8+(已安装并加入 PATH)
- 已安装项目依赖:
pip install -r requirements.txt,以及pip install parasail
建议:若当前环境安装了大量科学计算库(如 pandas、torch、tensorflow),打包会较慢且 exe 较大。可新建虚拟环境只装必要依赖再打包:
python -m venv venv_build
venv_build\Scripts\activate
pip install -r requirements.txt parasail pyinstaller
pyinstaller --noconfirm GeneType.spec-
打开命令提示符或 PowerShell,进入项目目录:
cd D:\workplace\GeneType -
双击运行
build_exe.bat,或在命令行执行:build_exe.bat
脚本会自动安装 PyInstaller(若未安装)、检查依赖并打包。
-
打包完成后,可执行文件位于:
dist\GeneType.exe
说明:spec 中已通过 collect_all('parasail') 打包 parasail.dll。若未打包该 DLL,exe 内 parasail 无法加载,会走 Biopython 等回退比对,结果会与直接运行 python genotype_gui.py 不一致。打包后建议用同一批数据对比 exe 与 Python 结果是否一致。
- 无需安装 Python,将
GeneType.exe复制到任意 Windows 10/11 电脑即可运行。 - 建议将
GeneType.exe与known_polymorphisms.txt放在同一目录(若需使用已知多态性过滤);exe 内已包含该文件,运行时优先使用 exe 内嵌版本。 - 参考序列(.dna)和测序文件(.ab1)由用户在界面中选择,无路径限制。
- 首次运行若杀毒软件提示,请选择“允许”或“信任”(PyInstaller 打包的程序可能被误报)。
重新打包前:请先关闭正在运行的 GeneType.exe,否则会报「拒绝访问」无法覆盖 dist 下的 exe。
PyInstaller 生成的 exe 常被 Windows Defender 误报。若打包在「Copying icon to EXE」阶段报错,请先排除项目目录再打包:
- 打开 Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 排除项 → 添加或删除排除项
- 添加排除项 → 文件夹 → 选择项目目录(如
D:\workplace\GeneType) - 重新执行打包:在项目目录下打开 PowerShell 或 命令提示符,执行:
pyinstaller --noconfirm GeneType.spec
- 打包完成后,exe 在
dist\GeneType.exe。分发到其他电脑时,若对方杀毒软件提示,选择「允许」或「信任」即可。
若需自定义打包参数,可手动执行:
pip install pyinstaller
pyinstaller --noconfirm GeneType.spec或不用 spec 文件:
pyinstaller --onefile --windowed --name GeneType ^
--add-data "known_polymorphisms.txt;." ^
genotype_gui.py(Windows 下 --add-data 使用分号 ; 分隔路径与目标目录。)