如何将多个pytest测试文件通过PyInstaller打包为可直接运行的exe文件

核心逻辑 #

你之前打包失败、无法直接运行的核心原因是：python -m pytest是调用pytest模块执行测试的命令，PyInstaller无法直接识别命令对应的执行逻辑，需要先编写一个可执行的入口脚本封装pytest调用逻辑。 #

步骤1：编写pytest执行入口脚本 #

新建run_tests.py作为打包入口，内容如下：

import pytest
import sys
import os

# 适配PyInstaller打包后的临时运行目录，避免测试文件/资源找不到
if getattr(sys, '_MEIPASS', False):
    os.chdir(sys._MEIPASS)

if __name__ == '__main__':
    # 括号内填入你平时执行pytest时的所有参数，示例为执行当前目录下所有测试用例、输出详细日志
    exec_code = pytest.main(["./", "-v"])
    # 解决双击exe运行一闪而过的问题，执行完停留窗口
    input("测试执行完成，按任意键关闭窗口...")
    sys.exit(exec_code)

步骤2：执行PyInstaller打包命令 #

根据你的测试文件和依赖调整以下打包命令：

# Windows系统命令
pyinstaller -F --add-data "test_*.py;." --add-data "conftest.py;." --hidden-import pytest run_tests.py

# Mac/Linux系统命令
pyinstaller -F --add-data "test_*.py:." --add-data "conftest.py:." --hidden-import pytest run_tests.py

参数说明：

• -F：指定生成单个独立exe文件
• --add-data "源文件路径;目标路径"：将所有测试用例文件、conftest.py、pytest配置文件（pytest.ini/pyproject.toml）、测试依赖的外部数据/配置文件全部按该格式添加到打包列表。如果是子目录下的测试文件，直接添加整目录即可，例如--add-data "test_dir/*;test_dir/"
• --hidden-import：如果用到pytest第三方插件（如pytest-html、pytest-allure），需要把插件名也加到这个参数里，例如--hidden-import pytest_html，避免打包遗漏依赖

常见问题排查 #

• 打包时提示模块缺失：直接把缺失的模块名加到--hidden-import参数即可
• 运行exe提示找不到测试文件：检查所有测试相关的文件是否都已通过--add-data添加到打包列表，入口脚本的路径适配逻辑是否保留
• 插件功能不生效：确认对应插件名已经加到--hidden-import列表里

打包完成后的exe文件在生成的dist目录下，直接双击即可运行，也可以拖到控制台执行查看实时日志。

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