YoloV8 python程序打包

原创于 2026-04-13 14:09:18 发布 · 251 阅读

3 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#YOLO #python #开发语言

文章目录

前言
一、打包工具
二、打包命令
三、一些坑

前言

基于各种python库的检测程序，编写完毕后，如果要在其他电脑上运行，需要配置相同的python环境。可以将程序打包，即便目前电脑无相同python环境，也能够直接运行执行程序文件。

一、打包工具

PyInstaller

pip install pyinstaller

二、打包命令

代码如下（两种都可以）：

pyinstaller -F --collect-all ultralytics --collect-all torch --collect-data torchvision --add-data "best_train10.pt;." .\detect.py

pyinstaller -F --add-data "best_train10.pt;." .\detect.py

生成的exe文件在dist/detect.exe

三、一些坑

1.路径问题

永远不要写绝对路径，用相对路径，并且和 exe 放在同一文件夹。

import os
from ultralytics import YOLO

# 获取当前 exe/脚本所在目录
BASE_DIR = os.path.dirname(os.path.abspath(__file__))

# 权重路径（和py/exe同一目录）
model_path = os.path.join(BASE_DIR, "yolov8n.pt")  
# 如果你是自己训练的就写 best.pt

model = YOLO(model_path)

# 摄像头实时检测
model.predict(source=0, show=True, save=False)

2.exe打开闪退

你的命令里有 -w，看不到终端输出，去掉 -w，看问题出在哪里。
或者是
你加了–noconsole参数，所有错误信息都被隐藏了。

3.找不到权重文件

在这里插入图片描述
PyInstaller 不会自动打包你自己的外部资源文件（如.pt模型、图片、配置文件）。你用的–collect-all参数只会收集ultralytics、torch这些第三方库的资源，不会收集你项目根目录下的best_train10.pt。
同时，当 exe 运行时，os.path.abspath(file)指向的是临时解压目录（_MEIxxxx），而不是 exe 所在的目录，这是 PyInstaller 最常见的路径坑。
第一步：修改代码中的路径获取逻辑
将原来的BASE_DIR定义替换成这个兼容脚本和 exe 两种运行方式的版本：

import sys
if getattr(sys, 'frozen', False):
    # exe运行时：BASE_DIR = exe文件所在的目录
    BASE_DIR = os.path.dirname(sys.executable)
else:
    # 脚本运行时：BASE_DIR = 脚本文件所在的目录
    BASE_DIR = os.path.dirname(os.path.abspath(__file__))

# 模型路径（现在exe运行时会去exe同目录找best_train10.pt）
model_path = os.path.join(BASE_DIR, "best_train10.pt")

第二步：–add-data（关键）

pyinstaller -F --add-data "best_train10.pt;." .\detect.py

命令中加入–add-data。
–add-data “源文件;目标目录”：把best_train10.pt打包进 exe，运行时会自动解压到临时目录