Win11下使用Ultralytics model.tune遇PermissionError: [WinError 5]权限拒绝

架构老林

2026-6-25

问题：Win11下Ultralytics model.tune触发PermissionError: [WinError 5] 拒绝访问

已知条件

系统：Win11
运行环境：Miniconda创建的虚拟环境（Python 3.9.19），VSCode中使用管理员权限终端
异常表现：model.train可正常训练模型，调用model.tune时触发权限错误，未使用ray_tune
已尝试操作：重启电脑、取消临时文件夹只读属性、关闭Windows Defender实时保护、切换全局环境（但全局环境无法安装所需依赖）

复现代码

from ultralytics import YOLO

# Load a YOLOv8n model
model = YOLO(r'yolov8m.pt')

# Start tuning hyperparameters for YOLOv8n training on the COCO8 dataset
model.tune(data=r'coco8.yaml', epochs=1000, batch=16, device='0')

解决建议

给虚拟环境目录添加完全控制权限：找到Miniconda虚拟环境所在文件夹，右键→属性→安全→编辑→添加当前用户，勾选“完全控制”权限，应用后重试。
指定调优结果存储目录：在model.tune中添加project参数，指定一个当前用户有完全权限的自定义目录，示例：
```
model.tune(data=r'coco8.yaml', epochs=1000, batch=16, device='0', project=r'D:\YOLO_Tune_Results')
```
检查虚拟环境激活脚本权限：找到虚拟环境下的activate.bat脚本，右键→属性→点击“解除锁定”（若存在该选项），再重新以管理员终端激活环境。
降级Ultralytics版本：部分新版本tune模块在Win11下存在权限兼容问题，可尝试安装指定稳定版本：
```
pip install ultralytics==8.0.200
```
关闭占用虚拟环境文件的程序：比如文件管理器打开了虚拟环境目录、其他IDE进程在占用相关文件，关闭后重新运行代码。