roLabelImg 傻瓜式使用教程手把手版假设你已经安装好了 roLabelImg下面从打开软件开始一步一步教你标注。第 0 步准备工作先建好文件夹在你的电脑上提前建好以下文件夹⚠️ 路径里不能有中文D:\my_project\ ├── images\ ← 放你要标注的图片jpg/png ├── labels\ ← 标注结果会自动保存在这里先建好空文件夹 └── roLabelImg\ ← roLabelImg 源码/程序所在文件夹把你的图片全部丢进images文件夹里。第 1 步打开软件源码安装的用户cdD:\my_project\roLabelImg python roLabelImg.py安装包用户直接双击桌面快捷方式。打开后你会看到一个窗口大概长这样┌─────────────────────────────────────────────────────────┐ │ File Edit View Help ← 菜单栏 │ ├─────────────────────────────────────────────────────────┤ │ [Open] [Open Dir] [Save] [Change Save Dir] ... ← 工具栏│ ├───────────────────────────┬─────────────────────────────┤ │ │ Box List │ │ │ ┌─────────────────────┐ │ │ 图片显示区域 │ │ (这里会显示你画的框) │ │ │ 中间大片空白 │ └─────────────────────┘ │ │ │ │ │ │ Label List │ │ │ ┌─────────────────────┐ │ │ │ │ (这里显示所有类别) │ │ │ │ └─────────────────────┘ │ ├───────────────────────────┴─────────────────────────────┤ │ 状态栏 │ └─────────────────────────────────────────────────────────┘第 2 步打开图片文件夹点击工具栏上的「Open Dir」按钮或按快捷键Ctrl U在弹出的窗口中找到并选择你的图片文件夹D:\my_project\images点击「选择文件夹」✅ 此时中间区域会显示第一张图片左下角会显示图片文件名。第 3 步设置标注保存路径⚠️ 很重要点击工具栏上的「Change Save Dir」按钮在弹出的窗口中选择你之前建好的标签文件夹D:\my_project\labels点击「选择文件夹」✅ 之后你画的每一个框都会自动保存到这个文件夹里。第 4 步确认保存格式看工具栏或菜单栏确认当前保存格式是PascalVOCXML。roLabelImg 默认就是 VOC XML 格式一般不用改。保存的文件长这样图片名.xml第 5 步设置类别名称可选但推荐如果你每次画框都要手动输入类别名会很烦。可以提前设置好类别用记事本打开这个文件D:\my_project\roLabelImg\data\predefined_classes.txt把里面的内容全部删掉写上你自己的类别一行一个例如car ship airplane building保存文件重启 roLabelImg✅ 之后画框时会弹出列表让你直接选不用打字了。第 6 步开始画框核心操作️ 画一个旋转框按快捷键Ctrl R或点击工具栏的「Create Rotated Box」按钮鼠标变成十字光标✛在图片上按住鼠标左键不放拖动出一个矩形框松开鼠标左键✅ 此时会弹一个小窗口让你输入/选择类别名称如果设置了预定义类别 → 直接点击选择→ 点 OK如果没设置 →手动输入类别名比如car→ 点 OK框就画好了 调整框的角度旋转画完框后先点击选中这个框框会变成高亮然后按键效果Z逆时针旋转0.1°微调X顺时针旋转0.1°微调C逆时针旋转1°粗调V顺时针旋转1°粗调技巧先用C/V大范围转到差不多再用Z/X微调到精确位置。 调整框的大小和位置调整大小鼠标放到框的边缘或角点上出现调整光标后拖动即可移动位置鼠标放到框内部按住左键拖动整个框❌ 删除一个框在右侧Box List中点击选中你要删的框按键盘Delete键✅ 框就没了。第 7 步保存画完当前图片的所有框后按Ctrl S或点击工具栏的「Save」按钮✅ 在D:\my_project\labels\文件夹里会出现一个 XML 文件比如img001.xml。第 8 步切换到下一张图片操作快捷键下一张D上一张A按D后自动跳到下一张图片继续从第 6 步开始画框。 如果你开启了自动保存菜单 → View → 勾选Auto Save mode切换图片时会自动保存不用每次按 CtrlS。第 9 步重复直到标完所有图片画框 (CtrlR) → 选类别 → 调角度 (Z/X/C/V) → 保存 (CtrlS) → 下一张 (D) 画框 (CtrlR) → 选类别 → 调角度 (Z/X/C/V) → 保存 (CtrlS) → 下一张 (D) 画框 (CtrlR) → 选类别 → 调角度 (Z/X/C/V) → 保存 (CtrlS) → 下一张 (D) ...直到所有图片标完 标注结果长什么样打开labels文件夹里的 XML 文件内容大概是这样的annotationfilenameimg001.jpg/filenamesizewidth1024/widthheight1024/height/sizeobjectnameship/name← 类别名robndboxcx512.0/cx← 框中心点 xcy300.0/cy← 框中心点 yw120.0/w← 框的宽h60.0/h← 框的高angle0.785/angle← 旋转角度弧度/robndbox/object/annotation这就是旋转框的五元组(中心x, 中心y, 宽, 高, 角度)⚡ 全部快捷键速查表建议截图保存快捷键功能Ctrl U打开图片文件夹Ctrl R创建旋转框最常用Ctrl S保存标注Ctrl D复制当前框Ctrl 放大图片Ctrl -缩小图片Ctrl F适应窗口大小D下一张图片A上一张图片Z逆时针旋转 0.1°X顺时针旋转 0.1°C逆时针旋转 1°V顺时针旋转 1°Delete删除选中的框Ctrl 鼠标滚轮缩放图片 常见问题Q画框的时候框是歪的怎么调正选中框后用Z/X/C/V慢慢调角度调到水平或你需要的角度。Q我标了一半软件崩了之前的标注还在吗如果你按过CtrlS就在。没保存的就丢了。所以建议开启 Auto Save mode。Q能不能一次标多张图再保存可以但强烈不建议。万一崩溃全丢。开自动保存最稳。Q标注完的数据怎么给 YOLOv8-OBB 用roLabelImg 输出的是 VOC XML 格式YOLOv8-OBB 需要 YOLO TXT 格式。需要写一个转换脚本把 XML 转成x_center y_center width height angle class_id格式的 TXT。如果需要转换脚本可以再问我。✅ 一句话总结操作流程打开图片目录 → 设置保存目录 →CtrlR画框 → 选类别 →Z/X/C/V调角度 →CtrlS保存 →D下一张 → 重复就这么简单去试试吧