使用cx_Freeze打包Python项目为.exe时遇cv2.gapi.wip属性错误

问题原因 #

cx_Freeze在扫描模块依赖时，误将cv2.gapi.wip识别为需要__path__属性的包，但实际上它是一个普通模块，不存在该属性，导致打包过程抛出错误。

可行解决方案 #

1. 在setup.py中排除冲突模块 #

修改setup.py的build_exe配置，添加excludes参数排除cv2.gapi相关子模块：

from cx_Freeze import setup, Executable

exe = Executable(script="main.py")

setup(
    name="YourProject",
    version="1.0",
    executables=[exe],
    options={
        "build_exe": {
            "excludes": ["cv2.gapi", "cv2.gapi.wip"],
            "include_files": [("images", "images"), ("testFiles", "testFiles")]
        }
    }
)

2. 显式导入所需的OpenCV子模块 #

在项目入口文件（如main.py）顶部添加代码，提前导入实际用到的cv2子模块，避免cx_Freeze自动扫描所有未使用的子模块：

import cv2
# 只导入你项目实际用到的子模块，示例：
from cv2 import imread, imwrite, cvtColor

3. 调整依赖版本 #

如果前两种方法无效，尝试：

• 降级cx_Freeze到稳定版本：pip install cx_Freeze==6.15.0
• 或降级OpenCV到4.x分支的稳定版：pip install opencv-python==4.5.5.62

4. 手动修改cx_Freeze模块扫描逻辑（进阶） #

找到Python安装目录下Lib\site-packages\cx_Freeze\modulefinder.py，定位到检查模块__path__的代码段，添加对cv2.gapi.wip的判断，跳过该模块的路径检查。注意：此方法会修改库文件，后续升级cx_Freeze需要重新操作，不推荐作为首选。

验证 #

修改配置后重新执行打包命令：

python setup.py build

进入build目录下的生成文件夹，运行.exe文件确认功能正常。

内容的提问来源于stack exchange，提问作者s.eyal