LabelImg安装使用教程：YOLOv12训练数据标注完整指南

LabelImg是一款开源的图像标注工具，广泛用于计算机视觉项目，如YOLOv12等目标检测模型的训练数据准备。本教程基于原帖子内容，整理出LabelImg的安装、配置及使用步骤，帮助用户快速上手数据标注工作。

一、LabelImg简介

LabelImg支持多种标注格式，包括YOLO、PASCAL VOC等。用户可以通过图形界面绘制边界框，为图像中的对象添加标签，从而生成训练数据集。原帖子以YOLOv12训练为背景，介绍了LabelImg的完整流程。

二、安装LabelImg

安装前需确保系统已安装Python3和相关依赖。以下是基于Linux系统的安装步骤：

sudo apt-get install pyqt5-dev-tools
pip3 install lxml
git clone https://github.com/tzutalin/labelImg.git
cd labelImg

这些命令会安装必要的PyQt5工具和lxml库，然后克隆LabelImg仓库到本地。

三、编译与错误解决

进入LabelImg目录后，运行编译命令：

make all

但在编译过程中，可能会遇到错误，例如：

pyrcc5 -o libs/resources.py resources.qrc
python3 -m unittest discover tests
....Remove setting pkl file $/home/ps/.labelImgSettings.pkl
...E..
======================================================================
ERROR: test_setInvaleLocaleToEnv_printErrorMsg (test_stringBundle.TestStringBundle)
----------------------------------------------------------------------
Traceback (most recent call last):
File "/home/ps/dev/yolo/label/labelImg/tests/test_stringBundle.py", line 18, in test_setInvaleLocaleToEnv_printErrorMsg
prev_lc = os.environ['LC_ALL']
File "/usr/lib/python3.10/os.py", line 680, in __getitem__
raise KeyError(key) from None
KeyError: 'LC_ALL'
----------------------------------------------------------------------
Ran 10 tests in 0.105s
FAILED (errors=1)
make: *** [Makefile:11: testpy3] Error 1

该错误是由于环境变量LC_ALL未设置所致。解决方案是设置环境变量：

export LC_ALL=en_US.UTF-8

设置后重新运行make all，编译应能顺利完成。

四、启动与使用LabelImg

编译完成后，可通过以下命令启动LabelImg：

python3 labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]

其中，IMAGE_PATH是图像文件夹路径，PRE-DEFINED CLASS FILE是预定义类别文件路径。若不加参数，工具会使用默认路径和类别文件（位于data/predefined_classes.txt）。

例如，指定图像路径和类别文件：

python3 labelImg.py ../../dataset/test/images/ ../../dataset/test/classes.txt

启动后，建议在界面中勾选“Auto Save”选项，以自动保存标注结果。

五、标注快捷键

LabelImg提供了一系列快捷键，提升标注效率：

• w：创建矩形框
• d：切换到下一张图像
• a：切换到上一张图像
• del：删除选中的标注矩形框

使用这些快捷键，用户可以快速完成图像标注。标注结果默认保存为XML文件（PASCAL VOC格式），也可根据需要转换为YOLO格式。

六、总结与引导

本教程涵盖了LabelImg的安装、编译错误解决及基本使用，为YOLOv12等模型的数据集准备提供了基础。由于原帖子包含更多细节，如图像示例和视频讲解，建议访问原帖子阅读完整内容。点击超链接查看：YOLOv12 训练从这里开始：LabelImg 标注数据集。

原帖子内容来源：https://bbs.eeworld.com.cn/thread-1311318-1-1.html