labelimg如何正确打开TXT标注文件？

Question

**问题：LabelImg如何正确打开TXT标注文件？** 在使用LabelImg进行图像标注时，用户常遇到如何正确加载与查看TXT格式标注文件的问题。LabelImg默认生成的是XML文件，但有时需要导入TXT文件，例如YOLO格式的标签。此时，用户需确保TXT文件与图像文件同名且路径正确，并在LabelImg中正确配置classes.txt。然而，部分用户因文件路径错误、格式不匹配或未切换至YOLO模式导致无法正常加载TXT标注文件。如何正确设置LabelImg以支持TXT标注文件的打开与编辑？

Answer 1

一、LabelImg简介与TXT标注文件支持机制

LabelImg 是一个广泛使用的图像标注工具，支持生成 XML 格式的 Pascal VOC 标注文件。然而，在目标检测项目中，尤其是使用 YOLO（You Only Look Once）模型时，通常采用 TXT 格式的标注文件。

LabelImg 从 1.8.0 版本起开始支持 YOLO 格式的 TXT 标注文件加载与编辑。要正确打开 TXT 标注文件，用户需要理解 LabelImg 的文件加载机制和 YOLO 的标签格式。

二、YOLO格式TXT标注文件结构

YOLO 格式的标签文件为纯文本文件（.txt），每行表示一个标注对象，结构如下：

• class_id：类别编号（从0开始）
• x_center, y_center：目标框中心点坐标（归一化到 [0,1]）
• width, height：目标框的宽和高（同样归一化）

例如：

0 0.5 0.5 0.2 0.3
1 0.7 0.2 0.1 0.1

三、LabelImg加载TXT标注文件的步骤

1. 准备图像与TXT文件：确保每张图像（如 image.jpg）都有一个同名的 image.txt 文件。
2. 放置路径一致：图像和 TXT 文件应放在同一目录下，LabelImg 默认在图像目录中查找标注文件。
3. 配置classes.txt：在 LabelImg 的安装目录下创建或修改 data/predefined_classes.txt 文件，按顺序列出所有类别名称。
4. 切换为YOLO模式：在 LabelImg 中点击 View -> Auto Save mode 和 Open Dir 后，选择 Change Save Dir，并点击 PascalVOC 切换至 YOLO 模式。
5. 加载图像目录：使用 Open Dir 打开包含图像和 TXT 文件的目录，LabelImg 将自动加载对应的 TXT 标注。

四、常见问题与排查方法

问题现象	可能原因	解决方法
TXT文件未显示	未切换至YOLO模式	点击 PascalVOC 切换为 YOLO 模式
加载失败或报错	文件名不一致或路径错误	确保图像与TXT文件同名，并位于同一目录
类别显示为数字	未配置或配置错误的classes.txt	检查 data/predefined_classes.txt 文件内容是否正确
无法保存修改	未设置保存路径	点击 Change Save Dir 设置保存目录

五、进阶：LabelImg源码修改支持自定义格式

对于高级用户，若需支持非标准 YOLO 格式（如多列、附加信息等），可对 LabelImg 源码进行扩展。主要修改文件为：

• labelImg.py：主程序逻辑
• yolo.py：YOLO 格式读写模块

示例代码片段（读取自定义TXT格式）：

def parse_yolo_format(filename, classes):
    with open(filename, 'r') as f:
        lines = f.readlines()
    shapes = []
    for line in lines:
        parts = line.strip().split()
        class_id = int(parts[0])
        x_center, y_center, w, h = map(float, parts[1:5])
        shape = {
            'label': classes[class_id],
            'points': convert_bbox_to_points(x_center, y_center, w, h)
        }
        shapes.append(shape)
    return shapes

六、流程图：LabelImg加载TXT文件过程

graph TD A[启动LabelImg] --> B[切换为YOLO模式] B --> C[打开图像目录] C --> D[查找同名TXT文件] D --> E{TXT文件存在?} E -->|是| F[读取class_id与坐标] E -->|否| G[提示未找到标注] F --> H[加载classes.txt] H --> I[显示标注框]