以下是 YOLO11 环境配置超详细教程(Windows + Anaconda + Python 小白专用,2026年1月最新版)。
目标:让零基础小白也能在 Windows 上成功跑通 YOLO11 目标检测(包括 GPU 版和 CPU 版)。
YOLO11 是 Ultralytics 公司 2024 年 9 月发布的最新版本,安装方式与 YOLOv8/v10 几乎完全相同,主要通过 pip install ultralytics 或 conda-forge 通道完成。
推荐配置(小白最稳组合)
| 项目 | 推荐版本/选项 | 说明 |
|---|---|---|
| 系统 | Windows 10 / 11 (64位) | — |
| Python | 3.11 或 3.12 | 3.8~3.12 都支持,3.11 最稳定 |
| 包管理 | Anaconda / Miniconda | 强烈推荐(管理 PyTorch + CUDA 很方便) |
| GPU 支持 | NVIDIA RTX 系列(CUDA 11.8/12.x) | 无 GPU 也能跑(速度慢 5–20 倍) |
| Ultralytics | 最新版(≥8.3.0) | 包含 YOLO11 支持 |
第一步:安装 Anaconda(如果还没装)
- 打开浏览器,访问官网:
https://www.anaconda.com/download - 选择 Windows → 64-bit Graphical Installer(约 600–800 MB)
- 下载完成后双击安装:
- “Just Me” (推荐)
- 勾选 Add Anaconda3 to my PATH environment variable(非常重要!很多小白卡在这里)
- 其他一路 Next
- 安装完后,Win + S 搜索并打开 Anaconda Prompt(不是普通 cmd!)
- 输入下面命令验证:
conda --version
python --version
看到版本号就成功。
第二步:创建专用虚拟环境(强烈推荐)
不要在 base 环境里乱装包,会污染全局。
在 Anaconda Prompt 中依次输入:
# 1. 创建环境(名字随便起,这里用 yolo11)
conda create -n yolo11 python=3.11 -y
# 2. 激活环境(以后每次用都要先激活)
conda activate yolo11
# 看到命令行前面出现 (yolo11) 就成功激活了
提示:以后开机/重启后都要先打开 Anaconda Prompt,然后输入 conda activate yolo11
第三步:安装 Ultralytics(YOLO11 核心包)
有两种主流方式,任选一种(推荐第一种 pip 方式,更快更新)
方式 A:最推荐(pip 安装,官方首推)
# 在激活的环境里运行
pip install -U ultralytics
-U表示升级到最新版- 安装过程会自动拉取 torch、torchvision、opencv 等依赖(可能需要 5–15 分钟)
方式 B:用 conda-forge 通道(适合网络慢或想统一用 conda 管理)
conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=12.1 ultralytics -y
- 如果你确定要用 CUDA 12.1(RTX 30/40 系列常见)
- 或者换成
pytorch-cuda=11.8(老卡常见)
安装完验证(超级重要!)
# 在 Anaconda Prompt 中输入 python 进入交互模式
python
# 然后一行一行敲
import ultralytics
ultralytics.checks()
你应该看到类似输出:
Ultralytics YOLOv8.3.x CPU
Setup complete (xxx packages in xxx environments)
torch version xx.x.x+cu121 or cpu
...
如果出现 YOLO11 相关信息,恭喜环境基本成功!
第四步:GPU 支持检查(有独显的小伙伴重点看)
- 先确认你的显卡驱动是否最新:
- NVIDIA 官网下载 GeForce Experience 或直接驱动
- 打开 cmd 输入
nvidia-smi,看到版本号 ≥ 535 即可
- 如果上面
ultralytics.checks()显示torch ... +cu121或+cu118,说明 GPU 已可用 - 简单测试 GPU 是否被识别:
import torch
print(torch.cuda.is_available()) # 应输出 True
print(torch.cuda.get_device_name(0)) # 显示你的显卡型号
print(torch.backends.cudnn.version()) # 显示 cuDNN 版本
如果输出 False → 常见原因:
- 没装 NVIDIA 驱动 / 驱动太老
- PyTorch 没带 CUDA(重装时指定 pytorch-cuda)
- Anaconda 环境冲突 → 删掉环境重来
第五步:跑第一个 YOLO11 示例(目标检测 Hello World)
在 Anaconda Prompt(已激活 yolo11 环境):
# 方法1:命令行直接跑(最简单)
yolo predict model=yolo11n.pt source='https://ultralytics.com/images/bus.jpg'
会自动下载 yolo11n.pt(最小的模型),然后在当前目录生成 runs/detect/predict/ 文件夹,里面有带框的图片。
方法2:Python 脚本方式(推荐学习用)
新建一个文件 test_yolo11.py,内容如下:
from ultralytics import YOLO
# 加载模型(n=最快小模型,s/m/l/x 依次更大更准)
model = YOLO("yolo11n.pt") # 第一次会自动下载 ~6MB
# 预测图片/视频/摄像头
results = model.predict(
source="bus.jpg", # 换成你自己的图片路径
# source=0, # 0=笔记本摄像头
# source="video.mp4", # 视频文件
save=True, # 保存结果到 runs/detect/
conf=0.25, # 置信度阈值
iou=0.45 # NMS IoU 阈值
)
# 打印结果
for result in results:
print(result.boxes) # 检测框信息
result.show() # 弹出结果窗口
运行:
python test_yolo11.py
第六步:常见问题 & 解决方案(小白高频坑)
| 问题 | 解决方案 |
|---|---|
| pip install 卡住/超时 | 换国内镜像:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ultralytics |
| No module named ‘torch’ | 重新安装:pip uninstall torch torchvision 然后重新 pip install ultralytics |
| CUDA not available | 检查 nvidia-smi → 确认驱动 → 重装 pytorch cuda 版 |
| DLL load failed | 显卡驱动太老 / CUDA 与驱动不匹配 → 更新驱动到最新 |
| ultralytics 版本太旧 | pip install -U ultralytics 强制升级 |
| 内存不足 / 显存爆炸 | 用 yolo11n.pt(最小的),或加参数 imgsz=320、batch=1 |
第七步:后续学习建议(小白进阶路线)
- 官方文档(最权威):https://docs.ultralytics.com/models/yolo11/
- 快速 CLI 使用:https://docs.ultralytics.com/modes/predict/
- 训练自己的数据集:先看 Roboflow 教程 → 做 YOLO11 自定义数据集
- 视频教程推荐(2024–2025 年仍适用):
- YouTube 搜索 “YOLO11 Windows Anaconda tutorial”
- 重点看 Ultralytics 官方频道或 “The Coding Bug” 等
祝你顺利跑通第一张带框图片!
有任何一步报错,直接把错误信息贴出来,我帮你 debug~