ubuntu20.04安装yolov8的2种方法

Ultralytics YOLOv8官方文档：
https://docs.ultralytics.com/zh

YOLO：YOU ONLY LOOK ONCE

安装方式有2种，1是通过pip安装，2是通过git克隆源码安装。

一、第1种安装方法：pip安装

第一步：创建并激活 Python 虚拟环境
使用虚拟环境可以隔离项目依赖，避免不同项目之间的库版本冲突

1、创建虚拟环境
python3 -m venv yolov8_env

如果创建失败，显示以下：
The virtual environment was not created successfully because ensurepip is not available. On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.

apt install python3.8-venv

You may need to use sudo with that command. After installing the python3-venv package, recreate your virtual environment.

解决方法：
查看当前的python3版本
python3 --version
根据错误提示，你需要安装 Python 3.8 的 venv 包。
sudo apt install python3.8-venv
问题解决后再重新创建虚拟环境。

2、激活虚拟环境
source yolov8_env/bin/activate

一次创建后，后续不需要重新创建，下次使用时，直接激活。
激活后，你的终端提示符前会出现 (yolov8_env) 字样。
同时，在文件夹也能看到yolov8_env的文件夹。

第二步：安装 ultralytics 包
这是 YOLOv8 的官方库，包含了模型、训练工具和推理接口。为了加快下载速度，可以使用国内的镜像源。
pip install ultralytics -i https://pypi.tuna.tsinghua.edu.cn/simple

第三步：验证安装
执行一条简单的命令来检查环境是否配置成功。
yolo predict model=yolov8n.pt source=‘https://ultralytics.com/images/bus.jpg’

这个命令会自动下载一个预训练的轻量级模型 (yolov8n.pt)，并对示例图片进行检测。如果一切顺利，你会看到运行日志，并且最终告诉你结果保存在哪个文件夹里（通常是 runs/detect/predict）。

如果想卸载，在终端中，执行以下命令即可：
pip uninstall ultralytics

运行后，系统会询问你是否确认删除，输入 y 即可完成卸载。
注意：如果你当初是在虚拟环境中安装的，请务必先激活对应的虚拟环境，再执行上述命令。

为了确保卸载干净，可以尝试导入该模块进行验证：
python -c “import ultralytics”

如果系统提示 ModuleNotFoundError: No module named ‘ultralytics’，就说明已经成功卸载了。

关闭虚拟环境：
deactivate

如果需要删除虚拟环境，则在退出虚拟环境后：
rm -rf my_project_env
执行后可以看到文件夹已经被删掉了。
也可以直接删除文件夹。

二、第2种安装方法：从github克隆源代码编译安装

第一步：安装 Git 和基础依赖

更新包列表
sudo apt update

安装 Git 和其他必要工具
sudo apt install git python3-pip

第二步：克隆 Ultralytics 仓库

克隆官方仓库
git clone https://github.com/ultralytics/ultralytics
（这个试过成功了）

或者使用国内镜像加速（如果官方访问慢）
git clone https://gitclone.com/github.com/ultralytics/ultralytics.git
（这个我没试过）

进入项目目录
cd ultralytics

第三步：创建并激活虚拟环境（推荐）

如果之前没有安装 python3.8-venv
sudo apt install python3.8-venv

创建虚拟环境
python3 -m venv yolov8_env

激活虚拟环境
source yolov8_env/bin/activate

第四步：安装依赖和项目

安装项目依赖
pip install -e .

-e 参数表示以"可编辑"模式安装，你对代码的修改会立即生效

出现问题：
ERROR: File “setup.py” not found. Directory cannot be installed in editable mode: /home/yunhui/ultralytics
(A “pyproject.toml” file was found, but editable mode currently requires a setup.py based build.)
这个错误是因为你使用的 pip 版本与项目采用的 pyproject.toml 标准不完全兼容导致的。

解决方法：
升级 pip 到最新版本，使其能原生支持基于 pyproject.toml 的可编辑安装。
pip install --upgrade pip
然后再：pip install -e .

第五步：验证安装

终端输入以下命令测试：
yolo predict model=yolov8n.pt source=‘https://ultralytics.com/images/bus.jpg’
（网络原因没有测试成功）