导出Pygame项目为.exe遇错，重装cv2时numpy编译失败求助

1. Pygame打包exe后的视频格式问题 #

将Pygame项目导出为.exe文件后运行报错，排查发现代码中多个对象返回None，确认是视频文件格式不支持的问题，相关代码片段如下：

cap = cv2.VideoCapture("C:/Users/Molly/OneDrive/Desktop/New folder (2)/VIDEOOO.mp4")

success, img = cap.read()
shape = img.shape[1::-1]
wn = pygame.display.set_mode(shape)
clock = pygame.time.Clock()

2. 重装OpenCV时的编译错误 #

确认格式问题后尝试重新安装cv2，终端出现如下错误：

building library "npymath" sources
No module named 'numpy.distutils._msvccompiler' in numpy.distutils; trying from distutils
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools"
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure

Encountered error while trying to install package.

numpy

note: This is an issue with the package mentioned above, not pip.
hint: See above for output from the failure.
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
error: subprocess-exited-with-error

× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> See above for output.

note: This error originates from a subprocess, and is likely not a problem with pip.

询问：该如何解决这些问题？当前的操作是否正确？

操作正确性判断 #

• 排查视频格式问题的方向是对的，但重装cv2并不是解决格式不支持的必要操作——格式不支持通常是OpenCV缺少对应编解码器，而非库本身损坏，重装大概率无法解决原问题。
• 重装时遇到的错误是因为numpy依赖C++编译环境，你的系统缺少对应的工具链。

分步骤解决 #

1. 解决视频格式不支持问题 #

• 把当前的MP4文件转换成OpenCV兼容的编码格式，比如用FFmpeg或格式工厂转成H.264编码的MP4，或者AVI格式。
• 转换后修改代码中的视频路径，优先用相对路径（避免打包exe后绝对路径失效），本地测试正常后再重新打包。
• 打包exe时，要确保视频文件被包含在打包目录中，或者用打包工具（如PyInstaller）的--add-data参数将视频文件指定到输出目录。

2. 解决重装OpenCV的编译错误 #

如果确实需要重装OpenCV：

• 安装Microsoft Visual C++ 14.0及以上版本的构建工具，安装时勾选"C++构建工具"核心组件。
• 重启终端后，使用预编译的OpenCV包安装：pip install opencv-python，这个版本不需要本地编译环境，能直接避开编译错误。
• 若仍有问题，先升级pip：python -m pip install --upgrade pip，再重新安装。

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