详细pyenv+venv+pip安装ultralytics

꧁执笔小白꧂2026-07-22 23:41

一、用pyenv管理python版本

‌pyenv‌：第三方版本管理器，‌只管理Python解释器版本‌，能在一台机器上安装切换多个Python版本（如3.8、3.10、3.11），不修改系统原生Python。

1、安装pyenv

复制代码

Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"

2、安装python

复制代码

pyenv install 3.10.11
pyenv global 3.10.11
python --version
#pyenv versions  # 查看本机所有已安装Python版本

二、用pyenv隔离ultralytics运行环境

‌venv‌：Python 3.3+ 内置的虚拟环境工具，‌只隔离依赖包‌，同一个Python版本下不同项目可以用venv互不干扰地安装不同版本的包。

1、创建yolo的虚拟运行环境

(1)创建虚拟环境

先下载ultralytics项目，如：D:\VS\Test2\ultralytics

复制代码

# 进入项目目录
cd D:\VS\Test2\ultralytics
# 锁定项目用的python版本
pyenv local 3.10.11
# 创建项目专属虚拟环境 同：python -m virtualenv D:\VS\Test2\ultralytics\.venv
python -m venv .venv
# 激活虚拟环境
.\.venv\Scripts\Activate.ps1

(2)安装项目依赖

复制代码

# 安装 setuptools 和 wheel；同：D:\VS\Test2\ultralytics\.venv\Scripts\python.exe -m pip install setuptools==82.0.1 wheel -i https://pypi.tuna.tsinghua.edu.cn/simple
.venv\Scripts\python.exe -m pip install setuptools==82.0.1 wheel -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装 ultralytics（可编辑模式） 代替pip install -U ultralytics
.venv\Scripts\python.exe -m pip install -e . --no-build-isolation -i https://pypi.tuna.tsinghua.edu.cn/simple
# 验证yolo依赖是否安装成功
yolo --version

(3)设置配置目录

复制代码

$env:YOLO_CONFIG_DIR="D:\VS\Test2\ultralytics\.ultralytics"

2、测试用yolo26n.pt进行检测

复制代码

.venv\Scripts\yolo predict model=yolo26n.pt  # 未下载的会重新下载

三、Onnx模型

1、导出Onnx模型

(1)安装依赖

复制代码

.venv\Scripts\python.exe -m pip install "onnx>=1.12.0,<2.0.0" onnxruntime "onnxslim>=0.1.82" -i https://pypi.tuna.tsinghua.edu.cn/simple

(2)执行导出

复制代码

.venv\Scripts\yolo export model=yolo26n.pt format=onnx

2、测试Onnx模型

复制代码

.venv\Scripts\yolo predict task=detect model=yolo26n.onnx imgsz=640
.venv\Scripts\yolo predict task=detect model=yolo26l.onnx imgsz=640
.venv\Scripts\yolo predict task=detect model=yolo11s.onnx imgsz=640

、

可以看出，Onnx正常导出。