Yolo26离线安装指南-创锋一号

YOLO26 离线安装指南

给工控机Windows [无互联网，客户现场无外网]装 YOLO26，纯 CPU 跑推理，编辑器用 VSCode。
思路：先在能上网的电脑上把工具下载好，再拷到目标机器去装。
Python 安装包
YOLO26 全部依赖包（.whl）
VS Code
VSCode Python 扩展（.vsix）

整体流程

📦 第一步：在联网机器上准备离线包

先找一台能上网的 Windows 电脑。系统位数、Python 版本尽量跟目标机器对齐，推荐Python 3.10 64 位。

1. 创建临时虚拟环境并下载 YOLO26 全部依赖

建议建个临时虚拟环境再下载，拿到的依赖比较全，不容易漏包：

python -m venv download_env download_env\Scripts\activate pip download ultralytics -d .\packages

跑完之后，packages里就是ultralytics（已经带了 YOLO26 代码）和它依赖的那一批.whl。里面有 CPU 版torch，也有opencv-python和numpy。

2. 单独下载 YOLO26 模型权重

模型权重.pt得自己去 Ultralytics 官方渠道或者 Hugging Face 把yolo26n.pt下下来，放进同一个离线包目录，具体用哪个模型权重，可以根据自己的实际情况进行选择。

3. 下载 VSCode Python 扩展的 .vsix 文件

下面两种方法都行：

微软应用官网下载；
通过已经联网的电脑上VSCode下载.visx；
工具抓取：在联网机器上用dlvsix工具自动抓。

下好ms-python.python-xxxx.vsix，跟其他东西打包在一起就行。

最终离线包结构

yolo26_offline\ ├── packages\ # 所有 .whl 依赖文件 ├── yolo26n.pt # 模型权重 └── ms-python.python-xxxx.vsix # VSCode Python 扩展

💿 第二步：在离线机器上安装 Python 与 YOLO26

1. 安装 Python（如未安装）

去python.org下 Windows 64 位安装包。装的时候务必勾上 “Add Python to PATH”。

2. 创建虚拟环境并离线安装 YOLO26

cd /d C:\yolo26_project python -m venv .venv .venv\Scripts\activate cd /d F:\setup\Yolo26\yolo26_offline pip install --no-index --find-links=.\packages ultralytics

参数	作用
`--no-index`	强制 pip 不联网
`--find-links=.\packages`	让 pip 从本地文件夹解析所有依赖

💡 万一提示缺某个包，回联网机器，在那个临时环境里pip download 包名 -d .\packages补下就行。

🌿 安装方式：虚拟环境 vs 全局环境

离线机器上装 YOLO26，装到哪里有两种选法。前面"步骤 2"走的是虚拟环境（推荐）。

对比

维度	🌿 虚拟环境（推荐）	🌐 全局环境
隔离性	依赖装在当前项目`.venv`内，不污染系统 Python	依赖装进系统 Python，全局可见
多项目共存	✅ 不同项目可各自独立版本	⚠️ 版本冲突风险，依赖会互相覆盖
适用场景	一台机器跑多个 Python 项目、需严格隔离	机器专用于 YOLO26、只这一个项目
VSCode 解释器	`项目目录\.venv\Scripts\python.exe`	系统 Python（如`C:\Python310\python.exe`）
是否需要激活	终端需先`.venv\Scripts\activate`	无需激活，直接`pip`即可

虚拟环境（推荐）

cd /d C:\yolo26_project python -m venv .venv .venv\Scripts\activate cd /d F:\setup\Yolo26\yolo26_offline pip install --no-index --find-links=.\packages ultralytics

每次开新终端都要先.venv\Scripts\activate激活，再运行pip/python；
VSCode「Select Interpreter」选中C:\yolo26_project\.venv\Scripts\python.exe。

全局环境（无需 venv）

不用建venv，也不用激活，直接往系统 Python 里装：

cd /d F:\setup\Yolo26\yolo26_offline pip install --no-index --find-links=.\packages ultralytics

装完之后python/pip默认就是系统环境；
VSCode「Select Interpreter」选全局 Python（比如C:\Python310\python.exe）；
⚠️ 注意：机器上要是还有别的 Python 项目，建议走虚拟环境，避免依赖互相覆盖，在工控领域，大部分设备都可以用全局环境。

🎯 第三步：在 VSCode 中离线安装扩展并配置

1. 离线安装 Python 扩展

打开 VSCode，按Ctrl+Shift+P，输入Install from VSIX，选拷过来的.vsix装上。

命令行也行：

code --install-extension F:\setup\Yolo26\yolo26_offline\ms-python.python-xxxx.vsix

2. 让 VSCode 选中你的离线环境

还是Ctrl+Shift+P，输入Python: Select Interpreter，指到这里：

C:\yolo26_project\.venv\Scripts\python.exe

3. 编写并运行测试脚本

项目目录下建个test_yolo26.py。模型路径一定要写正确路径，指到本地那份.pt，不然程序会联网下载权重：

importcv2fromultralyticsimportYOLO model=YOLO(r"F:\setup\Yolo26\yolo26_offline\yolo26n.pt")results=model(r"F:\setup\Yolo26\test\test.jpg")# 获取标注后的图像（BGR 格式，可直接给 OpenCV 用）annotated_img=results[0].plot()cv2.imshow("YOLO26 Detection",annotated_img)cv2.waitKey(0)# 按任意键关闭窗口cv2.destroyAllWindows()

F5 跑起来，正常的话能看到这样的效果（狗、汽车和自行车都被框出来，并且标注置信度）：

到这一步，环境就安装完成了，后续会继续更新Yolo的使用方法，欢迎同行点赞、关注，留言讨论。

企业官网建设流程全解析