将Python YOLO-V5的detect.py转为exe时遇路径与编码错误求助

问题根源分析 #

1. 初始缺失包：PyInstaller未自动识别YOLOv5的部分依赖模块，需手动指定。
2. 找不到general.pyc：手动复制__pycache__中的pyc文件无效，因为pyc文件是针对特定Python版本、环境编译的，与打包后的exe运行环境不兼容，强行复制会导致编码或结构错误。
3. UnicodeDecodeError：手动迁移pyc文件导致的编码不匹配，exe无法正确解析该文件。

正确解决方案 #

1. 确保环境依赖完整 #

先确认YOLOv5的所有依赖已安装，执行：

pip install -r requirements.txt

注意：Python版本需与YOLOv5兼容（如YOLOv5 6.x及以下支持Python 3.7）。

2. 使用带完整参数的PyInstaller命令 #

直接运行以下命令打包，让PyInstaller自动处理所有依赖和文件路径：

pyinstaller --onefile --console --add-data "models/*;models/" --add-data "utils/*;utils/" --add-data "data/*;data/" --hidden-import utils.general --hidden-import utils.datasets --hidden-import utils.loss --hidden-import utils.plots --hidden-import utils.torch_utils detect.py

参数说明：

• --onefile：打包为单个exe文件
• --console：保留控制台窗口方便查看日志（不需要的话换成--windowed）
• --add-data：将本地的models、utils、data文件夹内容同步到exe运行时的对应路径（Windows用;分隔，Linux/macOS用:）
• --hidden-import：指定PyInstaller未自动检测到的YOLOv5核心依赖模块

3. 修正detect.py中的路径引用（可选） #

如果exe运行时仍提示找不到文件，需将detect.py中的绝对路径改为相对路径，并通过PyInstaller的运行时临时路径获取文件：
在detect.py开头添加路径处理函数：

import sys
import os

def resource_path(relative_path):
    try:
        # 获取PyInstaller打包后的临时运行路径
        base_path = sys._MEIPASS
    except Exception:
        # 未打包时使用当前目录
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

然后将所有文件引用替换为该函数，比如加载模型的代码：

# 原代码
model = torch.hub.load('ultralytics/yolov5', 'custom', path='models/best.pt')
# 修改后
model = torch.hub.load('ultralytics/yolov5', 'custom', path=resource_path('models/best.pt'))

4. 避免手动操作pyc文件 #

绝对不要手动复制__pycache__中的pyc文件到utils文件夹，PyInstaller会自动处理依赖模块的编译与打包，手动操作只会导致兼容性问题。

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