当前位置：首页 > news >正文

yolo settings命令使用示例：自定义训练权重保存路径runs_dir

news 2026/7/8 16:09:18

在计算机视觉领域，Ultralytics YOLO 凭借其简洁的命令行接口（CLI）和强大的功能，成为了目标检测任务的首选框架。然而，许多开发者在初次接触或进行项目迁移时，常常会被各种路径配置问题困扰：YOLO 程序到底安装在哪？训练好的权重文件为什么会跑到奇怪的路径下？如何自定义这些路径？

本文将结合实战经验，从底层机制出发，全面解析 YOLO 的路径系统，帮你彻底告别“路径报错”与“找不到文件”的烦恼。

一、定位 YOLO 可执行文件：Windows 环境下的`which`替代方案

在 Linux 系统中，我们习惯使用which命令来查找可执行文件的路径。在 Windows 的 PowerShell 中，虽然没有原生的which，但提供了功能更强大的替代方案。当你需要确认当前终端调用的yolo究竟来自哪个虚拟环境时，可以使用以下方法：

1. 使用`Get-Command`（最推荐）

这是 PowerShell 中最标准的做法，等同于 Linux 的which。它会查找系统环境变量$env:PATH中的可执行文件。

Get-Commandyolo|Select-Object-ExpandProperty Source

注：如果只想获取纯路径而不需要其他信息，Select-Object -ExpandProperty Source是最佳选择。

2. 使用`where.exe`

Windows 系统自带的命令行工具，用法与 Linux 的which几乎完全一致。

where.exe yolo

3. 通过进程反查（适用于正在运行的 YOLO 任务）

如果你的 YOLO 训练任务正在后台运行，可以直接通过进程名获取它的绝对路径：

Get-Processyolo|Select-Object-ExpandProperty Path

二、揭秘权重保存机制：为什么文件不在程序目录下？

许多开发者会遇到这样的疑惑：我的yolo.exe明明安装在D:\Develop\anaconda3\...\Scripts\yolo.exe，为什么训练后的权重文件却保存到了E:\YOLO\xcms_v4\xcnvs\runs\detect\train5？

核心结论：YOLO 训练后的权重文件保存路径与yolo.exe所在的程序安装路径毫无关系。

YOLO 的权重保存机制是基于**全局配置文件（settings.json）**中的runs_dir参数决定的。无论你在系统的哪个目录下执行yolo train命令，YOLO 都会优先读取全局配置，将训练结果归档到指定的runs_dir路径下。

三、全局配置深度解析：掌控 YOLO 的核心枢纽

YOLO 的全局配置是管理路径的“总开关”。你可以通过在终端运行以下命令来查看当前的全局设置：

yolo settings

输出的 JSON 字典中，包含了几个至关重要的路径配置项：

{"datasets_dir":"E:\\YOLO\\xcms_v4\\datasets","weights_dir":"E:\\YOLO\\xcms_v4\\xcnvs\\weights","runs_dir":"E:\\YOLO\\xcms_v4\\xcnvs\\runs",...}

runs_dir：所有实验运行结果的根目录。执行yolo train时，YOLO 会自动在此目录下创建detect/train等子文件夹，存放权重文件（best.pt、last.pt）、日志和预测结果。
weights_dir：存放模型权重的目录，通常在你使用yolo export等命令时用到。
datasets_dir：数据集的默认根目录，用于解析自定义数据集 YAML 文件中的相对路径。

四、如何自定义训练权重保存路径？

如果你希望将训练结果固定保存到特定的外部硬盘或项目目录，可以通过以下三种方式进行灵活配置：

方法一：修改全局配置（一劳永逸）

如果你希望所有训练任务都默认保存到特定路径，可以直接修改全局配置。

# 在 PowerShell 中运行yolo settings runs_dir="D:\MyNewYOLOPath\runs"

或者在 Python 脚本中动态修改：

fromultralyticsimportsettings settings.update({"runs_dir":"D:/MyNewYOLOPath/runs"})

方法二：命令行指定`project`和`name`（单次生效）

如果不希望改变全局设置，只想将某次特定的训练保存到指定位置，可以在训练命令中直接传入参数：

yolo detect traindata=your_data.yaml model=yolov8n.pt project=D:\YOLO_Weights name=run1

执行后，权重文件将精确保存在D:\YOLO_Weights\run1\weights\best.pt。

方法三：了解默认自增机制

如果你不指定任何路径，YOLO 会默认在当前工作目录或全局runs_dir下创建runs/detect/文件夹。为了防止覆盖之前的训练结果，YOLO 会自动创建train、train2、train3等自增文件夹。每次训练完成后，记得前往数字最大的文件夹中提取你的best.pt。