roLabelImg 傻瓜式使用教程

🍼 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 步：打开图片文件夹

1. 点击工具栏上的「Open Dir」按钮（或按快捷键Ctrl + U）
2. 在弹出的窗口中，找到并选择你的图片文件夹：

   D:\my_project\images

3. 点击「选择文件夹」

✅ 此时中间区域会显示第一张图片，左下角会显示图片文件名。

第 3 步：设置标注保存路径（⚠️ 很重要！）

1. 点击工具栏上的「Change Save Dir」按钮
2. 在弹出的窗口中，选择你之前建好的标签文件夹：

   D:\my_project\labels

3. 点击「选择文件夹」

✅ 之后你画的每一个框，都会自动保存到这个文件夹里。

第 4 步：确认保存格式

看工具栏或菜单栏，确认当前保存格式是PascalVOC（XML）。

roLabelImg 默认就是 VOC XML 格式，一般不用改。保存的文件长这样：图片名.xml

第 5 步：设置类别名称（可选但推荐）

如果你每次画框都要手动输入类别名，会很烦。可以提前设置好类别：

1. 用记事本打开这个文件：

   D:\my_project\roLabelImg\data\predefined_classes.txt

2. 把里面的内容全部删掉，写上你自己的类别，一行一个，例如：

   car ship airplane building

3. 保存文件，重启 roLabelImg

✅ 之后画框时，会弹出列表让你直接选，不用打字了。

第 6 步：开始画框！（核心操作）

🖱️ 画一个旋转框

1. 按快捷键Ctrl + R（或点击工具栏的「Create Rotated Box」按钮）
2. 鼠标变成十字光标✛
3. 在图片上按住鼠标左键不放，拖动出一个矩形框
4. 松开鼠标左键

✅ 此时会弹一个小窗口，让你输入/选择类别名称：

• 如果设置了预定义类别 → 直接点击选择→ 点 OK
• 如果没设置 →手动输入类别名（比如car）→ 点 OK

框就画好了！🎉

🔄 调整框的角度（旋转）

画完框后，先点击选中这个框（框会变成高亮），然后：

💡技巧：先用C/V大范围转到差不多，再用Z/X微调到精确位置。

📐 调整框的大小和位置

• 调整大小：鼠标放到框的边缘或角点上，出现调整光标后，拖动即可
• 移动位置：鼠标放到框内部，按住左键拖动整个框

❌ 删除一个框

1. 在右侧Box List中，点击选中你要删的框
2. 按键盘Delete键

✅ 框就没了。

第 7 步：保存！

画完当前图片的所有框后：

• 按Ctrl + S（或点击工具栏的「Save」按钮）

✅ 在D:\my_project\labels\文件夹里会出现一个 XML 文件，比如img001.xml。

第 8 步：切换到下一张图片

按D后自动跳到下一张图片，继续从第 6 步开始画框。

💡 如果你开启了自动保存（菜单 → View → 勾选Auto Save mode），切换图片时会自动保存，不用每次按 Ctrl+S。

第 9 步：重复，直到标完所有图片

画框 (Ctrl+R) → 选类别 → 调角度 (Z/X/C/V) → 保存 (Ctrl+S) → 下一张 (D) 画框 (Ctrl+R) → 选类别 → 调角度 (Z/X/C/V) → 保存 (Ctrl+S) → 下一张 (D) 画框 (Ctrl+R) → 选类别 → 调角度 (Z/X/C/V) → 保存 (Ctrl+S) → 下一张 (D) ...直到所有图片标完

📄 标注结果长什么样？

打开labels文件夹里的 XML 文件，内容大概是这样的：

<annotation><filename>img001.jpg</filename><size><width>1024</width><height>1024</height></size><object><name>ship</name>← 类别名<robndbox><cx>512.0</cx>← 框中心点 x<cy>300.0</cy>← 框中心点 y<w>120.0</w>← 框的宽<h>60.0</h>← 框的高<angle>0.785</angle>← 旋转角度（弧度）</robndbox></object></annotation>

这就是旋转框的五元组：(中心x, 中心y, 宽, 高, 角度)

⚡ 全部快捷键速查表（建议截图保存）

🚨 常见问题

Q：画框的时候框是歪的，怎么调正？

选中框后，用Z/X/C/V慢慢调角度，调到水平或你需要的角度。

Q：我标了一半，软件崩了，之前的标注还在吗？

如果你按过Ctrl+S，就在。没保存的就丢了。所以建议开启 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。如果需要转换脚本，可以再问我。

✅ 一句话总结操作流程

打开图片目录 → 设置保存目录 →Ctrl+R画框 → 选类别 →Z/X/C/V调角度 →Ctrl+S保存 →D下一张 → 重复

就这么简单！去试试吧 💪