YOLO项目从零开始：超详细运行教程（图文保姆级教学）

一键难忘

于 2025-07-29 16:56:27 发布

阅读量1.5k

点赞数 18

CC 4.0 BY-SA版权

分类专栏： Python领域开发技术应用技术文章标签： python 人工智能基础

本文链接：https://blog.csdn.net/weixin_52908342/article/details/149751481

Python领域开发技术应用技术专栏收录该内容

360 篇文章

订阅专栏

YOLO项目从零开始：超详细运行教程（图文保姆级教学）

YOLO（You Only Look Once）是一个基于深度学习的目标检测算法，广泛应用于智能识别领域。本篇保姆级教学将手把手教你如何从零开始运行一个YOLO项目，适合完全没有基础的新手。

注意：本指南为0基础新手，老手可跳着学习观看。

在这里插入图片描述

下载项目

下载后解压到本地目录，例如：D:\YOLOProject。

在这里插入图片描述

项目目录浅析

在这里插入图片描述

安装Python环境

打开 Python官网，下载 Python 3.8+ 版本（建议3.8/3.9，兼容性更好）。

安装时记得勾选 Add Python to PATH，然后点击 Install Now。

安装完成后，在终端或CMD中输入以下命令检查是否安装成功：

python --version

在这里插入图片描述

安装虚拟环境Anaconda使用conda创建、运行虚拟环境

在这里插入图片描述

🧪 安装虚拟环境（Anaconda方式）

如果你选择使用 Anaconda 管理环境（更图形化、管理方便），可按以下方式进行。

✅ 安装 Anaconda

访问官网：https://www.anaconda.com/products/distribution
下载适合你系统的 Anaconda 安装包（Windows/macOS/Linux）
一路默认安装即可（建议添加到系统 PATH）

安装完成后可通过以下命令验证是否安装成功：

conda --version

🧱 使用 conda 创建虚拟环境

打开 Anaconda Prompt 或终端，执行以下命令创建虚拟环境：

conda create -n yolo_env python=3.10 -y

这里我们创建了一个名为 yolov8_env 的虚拟环境，并指定 Python 版本为 3.9（YOLOv8 通常与 3.8/3.9兼容性较好）。

在这里插入图片描述

激活环境：

conda activate yolo_env

在这里插入图片描述

📦 使用 conda 安装依赖（此处可以不看，直接跳过，我们后面采用Pip安装依赖）

此处可以不看，直接跳过，我们后面采用Pip安装依赖

有些项目会提供 environment.yml 文件，可直接用以下命令构建环境：

conda env create -f environment.yml
conda activate yolov8_env

如果没有 environment.yml，就使用手动安装方式：

pip install -r requirements.txt

你也可以根据实际情况添加 GPU 加速支持，例如安装带 CUDA 的 PyTorch：

# 根据你显卡和系统选择合适版本：
conda install pytorch torchvision torchaudio pytorch-cuda=11.8 -c pytorch -c nvidia

安装Pycham

访问 PyCharm官网，下载社区版（Community）或专业版。

安装完成后启动 PyCharm。

若你已有其他编辑器（如 VSCode），也可以跳过此步骤。

在这里插入图片描述

✅ 配置 PyCharm 解释器为 Conda 环境（可选）

如果你在使用 PyCharm，也可以将 Conda 虚拟环境添加为项目解释器：

打开 PyCharm → File > Settings > Project > Python Interpreter
点击右上角齿轮图标 → Add
选择左侧的 Conda Environment
选择 Existing environment
选择路径（例如 C:\Users\你的用户名\anaconda3\envs\yolov8_env\python.exe）
点击 OK 即可

这样你就完成了 基于 Conda 的虚拟环境安装与配置，后续直接激活环境并运行 YOLO 项目即可。

打开项目

直接把项目拖到PyCharm里打开项目，点击信任项目。
在这里插入图片描述

选择虚拟环境

在设置里选择之前创建的环境。
在这里插入图片描述

安装依赖

重要；自查一下项目根目录下的requirements.txt和下面的内容是否一样，如果不一样，之前全部替换。

# Ultralytics requirements
# Usage: pip install -r requirements.txt

# Base ----------------------------------------
matplotlib>=3.2.2
numpy>=1.22.2 # pinned by Snyk to avoid a vulnerability
opencv-python>=4.6.0
pillow>=7.1.2
pyyaml>=5.3.1
requests>=2.23.0
scipy>=1.4.1
torch>=1.7.0
torchvision>=0.8.1
tqdm>=4.64.0

pandas>=1.1.4
seaborn>=0.11.0
# Extras --------------------------------------
psutil  # system utilization
py-cpuinfo  # display CPU info
# thop>=0.1.1  # FLOPs computation
# ipython  # interactive notebook
# albumentations>=1.0.3  # training augmentations
# pycocotools>=2.0.6  # COCO mAP
# roboflow


PyQt5==5.15.6
PyQt5-sip>=12.9.0
PyQt5-Qt5>=5.15.2
torch>=1.10.0
torchvision>=0.11.0
opencv-python>=4.5.5
numpy>=1.21.0
matplotlib>=3.5.1
pycocotools>=2.0.4
PyYAML>=6.0
tqdm>=4.64.0
ultralytics>=8.0.0