简介面向深度学习与计算机视觉任务labelImg是一款开源图像标注工具主要帮助研究者和开发者手工绘制边界框、添加多类别标签并输出PASCAL VOC标准XML标注文件为检测、分割等模型提供训练数据支撑。压缩包共108个文件约6.61MB包含Python源码及pyc编译文件、可执行启动脚本、示例图像与界面图标以及README等使用文档整体目录清晰解压后即可查看核心实现并准备运行。已有1138人学习下载。内容涵盖图形界面操作、W/A/S/D/Q等快捷键标注、自定义类别列表、多种常见图像格式读取等实用功能借助内置示例图和XML样例可以快速熟悉从打开图像、框选目标到保存标注的完整流程。通过查阅源码还能理解Qt界面布局与XML生成逻辑便于按需扩展或集成到标注管线中是深度学习数据预处理环节的一份实用参考。 做了几年目标检测相关的项目我几乎每天都要跟图像标注打交道。刚开始那会儿也试过几款标注工具但折腾到最后电脑里装得最稳的、打开最快的还是这个老牌的labelImg。别看它界面朴素得像上个世纪的软件真到了要批量出数据集的时候你就知道它有多靠谱了。这篇文章我不打算照着官方文档给你念一遍而是结合我实际使用的经验把labelImg从安装到实战再到那些网上搜不到答案的奇葩问题一次性讲透。1. 为什么到2024年我还在用labelImg很多人觉得深度学习都卷到这个程度了标注工具怎么也得是个带AI辅助的网页版吧这话没错像Label Studio、CVAT这些工具功能确实强大支持多人协作、自动标注、数据管理一条龙。但问题是如果你只是一个人做实验或者团队就三五个人跑一套CVAT的Docker环境再配数据库、配对象存储那折腾时间比标注本身还长。labelImg的定位非常清楚它就是给你本地画框用的没有花里胡哨的功能也不需要联网双击打开选好图片文件夹直接开干。它主打的格式是PascalVOCXML文件和YOLOTXT文件这两个恰恰是目标检测领域最通用的格式。你用labelImg标注完转成COCO格式也好、训练YOLO系列模型也好几乎是无缝衔接。我自己最常用的场景是给工业质检项目的缺陷样本做标注图片数量通常几千张类别也就四五个这种体量用labelImg反而效率最高。启动快、不卡顿、快捷键顺手这就是我离不开它的原因。如果你是一个刚入门目标检测的新手或者正在做一个中小规模的定制化检测项目labelImg绝对是你第一个应该上手的工具。它不会给你太多选择困难你只需要学会一件事把框画准。1.1 labelImg的核心能力与定位官方对labelImg的定义很简单一个开源的图像标注工具用Python和Qt编写支持PascalVOC和YOLO两种输出格式。它不负责帮你管理数据集不负责训练模型更不负责生成伪标签它只做标注这一件事。这种单一职责的设计反而让它的稳定性和易用性远超那些大而全的平台。从技术架构上看labelImg的标注流程是加载图片到画布你通过鼠标拖拽绘制矩形框然后为每个框打上类别标签保存后生成对应的文件名一致但后缀不同的标注文件。比如一张001.jpg的图片如果选择的标注格式是PascalVOC保存后就会生成001.xml如果选的YOLO格式保存后会生成001.txt。这个“同名不同后缀”的对应关系是很多新手最容易搞混的地方后面我会重点讲。1.2 与主流标注工具的对比参考用张表来说明labelImg和其他工具的区别你会更清楚它的适用边界工具部署方式输出格式协作能力适用场景labelImg本地安装VOC/YOLO无个人或小团队快速标注Label StudioWeb/Docker多格式强需要数据管理的大型项目CVATWeb/Docker多格式强团队协作、视频标注X-AnyLabeling本地安装多格式无需要AI辅助的标注这个对比不是要分个高下而是提醒你选标注工具不是越先进越好而是看它能不能和你的工作流无缝衔接。labelImg到今天仍然活跃恰恰说明了一批人对轻量级本地工具的需求始终存在。2. 安装与配置三种方式实测对比labelImg的安装在不同系统下差异很大尤其是Windows用户踩坑概率极高。我按照从推荐到不推荐的顺序把三种主流安装方式都给你过一遍。2.1 最省心的Windows安装方式Anaconda方案Windows下安装labelImg千万不要自己去GitHub下载源码然后手动编译因为依赖项Qt5、pyqt5这些库在Windows下编译容易出幺蛾子动不动就报C库缺失。我最推荐的方式是走Anaconda环境安装原因是能隔离出干净的环境不影响你日常的Python开发环境。conda create -n labelimg python3.9 conda activate labelimg pip install labelImg装完之后命令行输入labelImg就能打开。这里的重点在于labelImg的PyPI包名是labelImg两个大写字母L和I网上很多教程写的是labelimg你如果完全照抄pip会提示找不到包。另外Python版本建议用3.7到3.9之间太高的3.11、3.12版本在某些老版本labelImg上会出现Qt兼容问题直接一点就是闪退。如果你已经安装了完整版Anaconda网络环境又好用这条命令大概五分钟左右就能完成安装。装完以后每次使用只需要两步conda activate labelimg然后labelImg。2.2 Linux / macOS的两种常见安装方式Linux系统下安装会稍微复杂一点但也就两种路线。第一是用系统的包管理器在Ubuntu或Debian下可以先执行sudo apt-get install pyqt5-dev-tools python3-lxml安装依赖然后从GitHub克隆源码执行pyrcc5 -o libs/resources.py resources.qrc和python labelImg.py启动。这条路线适合你总共要安装很多Python工具并且想对所有工具保持源码控制的情况。第二种是macOS用户推荐的方式用Homebrew的Python环境和pip组合brew install python-tk pip install labelImgmacOS用户特别注意labelImg依赖Tkinter你在macOS上需要先安装python-tk不然打开时会报ModuleNotFoundError: No module named tkinter。这个问题在M1/M2芯片的Mac上尤其常见ARM架构下需要确认你的Python是用Homebrew装的而不是直接从官网下的那个版本。2.3 安装过程中的高频报错与处理办法安装阶段你大概率会遇到下面几个问题我把最常见的报错信息和解决方案整理成表方便你排查报错提示原因处理方法ModuleNotFoundError: No module named PyQt5缺少界面依赖库pip install pyqt5No module named requests缺少网络请求库pip install requestscommand gcc failedLinux缺少编译环境sudo apt-get install build-essential运行时提示找不到libGL.so.1系统缺少OpenGL库sudo apt-get install libgl1-mesa-glx双击图标没反应Windows下启动路径有问题使用命令行labelImg启动并查看报错这些报错其实都不可怕可怕的是报错之后你不知道去哪查。我的经验是凡是安装阶段的问题优先看英文原版README里面关于依赖的说明是最准确的。国内很多博客年代的软件版本已经过时了照抄反而容易出错。3. 界面功能全解析从打开到出第一批标注安装只是热身真正拉开差距的是你对这个工具细节的把控。我第一次用labelImg的时候因为不了解快捷键和自动保存机制多点了上千次鼠标后来想想真是冤枉。3.1 主界面关键区域逐一看labelImg打开后界面布局是典型的三段式最上面是菜单栏和工具栏左边是主画布区右边是标注列表和文件列表。这个界面初次看会觉得简陋但它每个区域都有明确分工。菜单栏里的Open Dir用来选择图片文件夹Change Save Dir用来指定标注文件生成的目录。注意这里有个很多人不知道的小技巧如果你不点Change Save Dir标注文件会默认保存到和图片同一个目录如果点了则保存到你指定的目录。我习惯把标注文件放在单独的Annotations文件夹里这样即便后期图片需要移动也不会担心混进一堆XML文件。画布区支持鼠标滚轮缩放同时按住Ctrl滚动可以微调缩放比例。标注列表展示当前图片中所有已经画好的框文件列表展示当前文件夹里所有图片的文件名你点击任意一个文件名就会立刻跳转到对应图片。这三块区域配合起来操作效率是很高的。3.2 画框和打标签的基础操作标注的基本流程是打开图片目录设置保存目录然后在画布上从目标左上角按住鼠标拖到右下角松开后弹出类别输入框填写类别名按回车确认。就这么简单但有几个细节直接影响你的标注质量。第一画框的时候尽量贴着物体的边缘。很多人为了省事框的范围比物体宽了10%这在目标检测里属于标注不精准最终会拉低模型的mAP值。第二类别名称必须统一一个项目里不要出现同一物体的两种叫法比如“person”和“people”应该统一成一种不然模型会当作两个类别去学。第三如果是一张图片里的同一个物体有多个实例要一个一个都标出来不要漏。3.3 快捷键列表与效率飞升实操真正让labelImg效率起飞的是快捷键。我建议你把下面这些快捷键记在脑子里能让你每天省下至少半小时的无效操作快捷键功能使用场景W开始画框画矩形、调整位置D 或 A切换到下一张/上一张图片连续标注时刷图CtrlS保存标注画完一张立即保存CtrlD复制当前框到下一张相似目标场景快速复制Delete删除选中框画错了直接删CtrlZ撤销上一步操作误操作后恢复 和 -放大/缩小图片观察小目标细节实际标注时我通常左手放在键盘上右手握鼠标。左手负责W键画框、D键翻页、CtrlS保存右手只管框选目标整套流程下来一张图上五个目标大约只需要20秒。如果你用自动保存模式也就是在View菜单里勾选Auto Saving那么画完一个框后会立刻保存到磁盘完全省去了按CtrlS的动作。4. 核心功能细节格式切换、自动保存与文件管理热词里有“labelimg标注工具切换正方形框不生效”和“labelimg闪退”这两个问题我都在实际项目中碰到过属于比较典型的“看着不严重但极其影响心情”的故障我单开一节说清楚。4.1 为什么快捷键W画正方形框没反应这个问题其实不是bug而是labelImg的快捷键设定逻辑造成的。在我用过的版本里画框是快捷键W键而画正方形框是ShiftW。很多人习惯了快捷键W想画正方形的时候仍然只按W自然不生效。加上Windows环境下输入法状态的影响如果处于中文输入模式Shift键会被输入法吃掉导致组合键识别失败。如果你确实需要画正方形框正确操作是先按Shift然后按W接着在画布上拖动鼠标。画出来的矩形会被强制锁定为正方形这个功能在标注圆形零件、正脸头像这类目标时特别好用。用完之后要切回普通矩形框再按一下W就可以恢复自由比例。还有一个小细节如果发现键盘快捷键全部失效先不要怀疑软件出了问题检查一下右下角输入法状态。把输入法切到英文模式快捷键立马恢复。这个坑至少浪费过我十分钟后来我把系统默认输入法直接设置成英文模式问题彻底杜绝。4.2 保存格式的切换VOC与YOLO的取舍在labelImg里通过菜单栏PascalVOC和YOLO两个选项来切换输出格式。网页上很多教程把这俩写成了两个功能看得人一头雾水其实就是两种格式的切换入口。PascalVOC格式XML文件存储的是目标框在原始图片像素坐标系中的左上角坐标和右下角坐标这种格式直观、可读性强适合调试时查看。YOLO格式TXT文件存储的是归一化后的中心点坐标和宽高也就是把xywh都缩放到0到1之间训练YOLO系列模型时效率更高。我的经验是如果你后续要用Ultralytics的YOLOv8训练推荐直接选YOLO格式如果你还需要做检测结果的二次处理或者和其他框架对接PascalVOC更稳妥。两种格式之间可以随意切换需要提醒的是当你修改了图片的尺寸比如从1920x1080改成640x640那么XML里的坐标不会自动缩放需要你自己重新框选。我自己习惯在项目最开始就把所有图片统一成固定尺寸避免后期返工。4.3 为什么labelImg总是闪退以及怎么防闪退这个问题是我在多个不同版本里都遇到的。经过排查最常见的诱因有三个。第一是图片路径中有中文。labelImg底层依赖Qt5Qt5在Windows环境下对中文路径的处理并不友好一旦图片路径或者保存目录包含中文闪退概率极高。解决办法就是所有数据集相关路径全部用英文不要带空格不要带中文这个习惯我从一开始就养成了。第二是图片格式问题。有些相机会生成特殊编码的JPG或者高动态范围的PNGlabelImg自带的图像读取库可能解析不了。遇到这种文件正确的做法不是去修改labelImg源码而是先用Python的OpenCV库把异常图片转成标准格式import cv2 def convert_image(input_path, output_path): img cv2.imread(input_path) if img is not None: cv2.imwrite(output_path, img, [cv2.IMWRITE_JPEG_QUALITY, 95])第三条是系统内存不足。当你一次性加载一个几千张图片的文件夹时labelImg虽然不会全部载入内存但它在切换图片时的资源回收机制并不高效。如果系统内存小于8G建议一次只标注一个子文件夹比如分成500张一批这样几乎不会触发闪退。如果闪退已经发生最快的恢复办法是重新打开labelImg并检查最近保存的标注文件是否完整。正常情况下只要打开过Auto Saving每个XML或TXT文件都会在画框完成后自动写入所以最多丢失最后一张图的最后一个框损其实可控。5. 实战流程与避坑指南标一批数据要经历什么东西讲再多不去实操一遍等于白看。这一节我以“用labelImg标注一批工业零件缺陷数据”为例把这个项目的完整流程走一遍。这部分内容你完全可以复用到其他场景。5.1 准备数据目录与预检开工之前先把数据目录结构定下来。我推荐下面这种布局dataset/ ├── images/ │ ├── 001.jpg │ ├── 002.jpg │ └── ... ├── labels/ └── classes.txt把图片全部扔进images目录然后打开labelImg点击左侧打开目录选择images点击更改保存目录选择labels接着在右边文件列表里随便点一张图确认能正常显示。这一步相当于体检如果你能顺利完成说明环境和路径都没问题可以开工。5.2 批量标注与质量自检流程标注的过程不需要多说了就是画框、打标签、翻页。但在批量标注时建议每标完成150张左右就停一下做一个自检打开对应的XML目录用文本编辑器随机抽查5个XML文件确认坐标数值没有明显异常类别名称统一标注数量与图片目测吻合。这个自检动作能帮你尽早发现系统性错误而不是等标完全部数据再回头返工。如果你想加速标注我教你一个常用技巧如果图片序列是连续视频帧先用labelImg手动标注第1帧和第10帧然后用方向键快速翻页凭借目视比较你会发现中间帧的目标框往往只需要微调就能复用。因为视频帧里的目标位移是渐变的labelImg会自动继承上一张的标注框吗不会但它提供了复制功能CtrlD可以把上一帧的标注框复制到当前帧你只需要拖动到新位置就行。5.3 多人协同标注时的文件合并如果你是一个人做项目这部分可以跳过。但如果团队分工比如两个人各标一半图片最后需要合并数据集这时就要注意一个坑labelImg输出的XML文件名与图片名完全一致但如果两个人用的是不同机器Windows下可能出现同名文件大小写不一致的情况在后续合并时Linux系统上就会产生重复。我的做法是让两个人在各自标注前先把图片文件名统一加上前缀比如A_xxx.jpg和B_xxx.jpg这样合并后就不可能冲突。6. 还要具备的延伸技能与经验总结最后这部分我想聊一些不那么基础、但对你提升标注效率很关键的技能。这些经验都不是官方文档里能翻到的属于“踩坑踩出来的心得”。6.1 用Python批量检查和修复标注文件标注完几百上千张图之后最怕出现的问题往往是全局性的比如某个类别的名称多打了个下划线或者某些XML文件坐标超出了图片边界。手动检查根本不现实这时候最好写一个小脚本扫一遍。下面这段代码可以检查YOLO格式的TXT文件中的坐标是否越界import os def check_yolo_labels(img_dir, label_dir): for img_file in os.listdir(img_dir): if img_file.endswith((.jpg, .png)): txt_file os.path.join(label_dir, img_file.replace(img_file.split(.)[-1], txt)) if not os.path.exists(txt_file): print(f缺少标注文件: {txt_file}) continue with open(txt_file, r) as f: for line in f: parts line.strip().split() if len(parts) ! 5: print(f格式错误: {txt_file}: {line}) else: x, y, w, h map(float, parts[1:5]) if x - w/2 0 or x w/2 1 or y - h/2 0 or y h/2 1: print(f坐标越界: {txt_file}: {line}) print(检查完成)这种自动化检查脚本算是给标注工作上了一道保险至少不用肉眼逐条核对。6.2 把labelImg嵌入你的个人标注流水线虽然labelImg本身功能单一但你可以通过脚本把它嵌入到复杂的流水线里。比如我用FastAPI写过一个内部工具上传一批图片到服务器服务器自动把图片存到指定目录然后返回一个标注任务ID我用labelImg在本地标注完以后再写脚本把标注文件上传回服务器完成归档。这个流程看起来多此一举但在团队协作里非常管用它让数据有了统一的出入口。另外一个好用的组合是labelImgcv2标注前用OpenCV写个脚本批量处理图片尺寸和格式保证所有图片都能被labelImg正常打开。标注完再写一个格式转换脚本把XML转成json或者把txt转成coco格式这样整个数据准备环节就完全封闭环了。6.3 核心使用方法总结新手必看说了这么多最后帮新手把最关键的几条使用方法浓缩一下。安装就两条命令conda建环境加pip安装打开以后先选图片目录再选保存目录画框快捷键是W保存是CtrlS翻页是D和A标签名称统一路径不能有中文格式选YOLO还是VOC看你后续训练框架YOLOv5/8就选YOLO其他框架一般选VOC。我见过不少人因为觉得labelImg界面简陋一开始就放弃结果绕了一圈用了各种大型工具后又回来了。工具的价值在于解决问题而不在于看起来多高级。至少在我的项目里labelImg始终是那个最不会掉链子的备胎同时也是最顺手的同路人。本文还有配套的精品资源点击获取 labelImg目标检测标注工具实战指南：安装、使用与避坑全解析
简介面向深度学习与计算机视觉任务labelImg是一款开源图像标注工具主要帮助研究者和开发者手工绘制边界框、添加多类别标签并输出PASCAL VOC标准XML标注文件为检测、分割等模型提供训练数据支撑。压缩包共108个文件约6.61MB包含Python源码及pyc编译文件、可执行启动脚本、示例图像与界面图标以及README等使用文档整体目录清晰解压后即可查看核心实现并准备运行。已有1138人学习下载。内容涵盖图形界面操作、W/A/S/D/Q等快捷键标注、自定义类别列表、多种常见图像格式读取等实用功能借助内置示例图和XML样例可以快速熟悉从打开图像、框选目标到保存标注的完整流程。通过查阅源码还能理解Qt界面布局与XML生成逻辑便于按需扩展或集成到标注管线中是深度学习数据预处理环节的一份实用参考。 做了几年目标检测相关的项目我几乎每天都要跟图像标注打交道。刚开始那会儿也试过几款标注工具但折腾到最后电脑里装得最稳的、打开最快的还是这个老牌的labelImg。别看它界面朴素得像上个世纪的软件真到了要批量出数据集的时候你就知道它有多靠谱了。这篇文章我不打算照着官方文档给你念一遍而是结合我实际使用的经验把labelImg从安装到实战再到那些网上搜不到答案的奇葩问题一次性讲透。1. 为什么到2024年我还在用labelImg很多人觉得深度学习都卷到这个程度了标注工具怎么也得是个带AI辅助的网页版吧这话没错像Label Studio、CVAT这些工具功能确实强大支持多人协作、自动标注、数据管理一条龙。但问题是如果你只是一个人做实验或者团队就三五个人跑一套CVAT的Docker环境再配数据库、配对象存储那折腾时间比标注本身还长。labelImg的定位非常清楚它就是给你本地画框用的没有花里胡哨的功能也不需要联网双击打开选好图片文件夹直接开干。它主打的格式是PascalVOCXML文件和YOLOTXT文件这两个恰恰是目标检测领域最通用的格式。你用labelImg标注完转成COCO格式也好、训练YOLO系列模型也好几乎是无缝衔接。我自己最常用的场景是给工业质检项目的缺陷样本做标注图片数量通常几千张类别也就四五个这种体量用labelImg反而效率最高。启动快、不卡顿、快捷键顺手这就是我离不开它的原因。如果你是一个刚入门目标检测的新手或者正在做一个中小规模的定制化检测项目labelImg绝对是你第一个应该上手的工具。它不会给你太多选择困难你只需要学会一件事把框画准。1.1 labelImg的核心能力与定位官方对labelImg的定义很简单一个开源的图像标注工具用Python和Qt编写支持PascalVOC和YOLO两种输出格式。它不负责帮你管理数据集不负责训练模型更不负责生成伪标签它只做标注这一件事。这种单一职责的设计反而让它的稳定性和易用性远超那些大而全的平台。从技术架构上看labelImg的标注流程是加载图片到画布你通过鼠标拖拽绘制矩形框然后为每个框打上类别标签保存后生成对应的文件名一致但后缀不同的标注文件。比如一张001.jpg的图片如果选择的标注格式是PascalVOC保存后就会生成001.xml如果选的YOLO格式保存后会生成001.txt。这个“同名不同后缀”的对应关系是很多新手最容易搞混的地方后面我会重点讲。1.2 与主流标注工具的对比参考用张表来说明labelImg和其他工具的区别你会更清楚它的适用边界工具部署方式输出格式协作能力适用场景labelImg本地安装VOC/YOLO无个人或小团队快速标注Label StudioWeb/Docker多格式强需要数据管理的大型项目CVATWeb/Docker多格式强团队协作、视频标注X-AnyLabeling本地安装多格式无需要AI辅助的标注这个对比不是要分个高下而是提醒你选标注工具不是越先进越好而是看它能不能和你的工作流无缝衔接。labelImg到今天仍然活跃恰恰说明了一批人对轻量级本地工具的需求始终存在。2. 安装与配置三种方式实测对比labelImg的安装在不同系统下差异很大尤其是Windows用户踩坑概率极高。我按照从推荐到不推荐的顺序把三种主流安装方式都给你过一遍。2.1 最省心的Windows安装方式Anaconda方案Windows下安装labelImg千万不要自己去GitHub下载源码然后手动编译因为依赖项Qt5、pyqt5这些库在Windows下编译容易出幺蛾子动不动就报C库缺失。我最推荐的方式是走Anaconda环境安装原因是能隔离出干净的环境不影响你日常的Python开发环境。conda create -n labelimg python3.9 conda activate labelimg pip install labelImg装完之后命令行输入labelImg就能打开。这里的重点在于labelImg的PyPI包名是labelImg两个大写字母L和I网上很多教程写的是labelimg你如果完全照抄pip会提示找不到包。另外Python版本建议用3.7到3.9之间太高的3.11、3.12版本在某些老版本labelImg上会出现Qt兼容问题直接一点就是闪退。如果你已经安装了完整版Anaconda网络环境又好用这条命令大概五分钟左右就能完成安装。装完以后每次使用只需要两步conda activate labelimg然后labelImg。2.2 Linux / macOS的两种常见安装方式Linux系统下安装会稍微复杂一点但也就两种路线。第一是用系统的包管理器在Ubuntu或Debian下可以先执行sudo apt-get install pyqt5-dev-tools python3-lxml安装依赖然后从GitHub克隆源码执行pyrcc5 -o libs/resources.py resources.qrc和python labelImg.py启动。这条路线适合你总共要安装很多Python工具并且想对所有工具保持源码控制的情况。第二种是macOS用户推荐的方式用Homebrew的Python环境和pip组合brew install python-tk pip install labelImgmacOS用户特别注意labelImg依赖Tkinter你在macOS上需要先安装python-tk不然打开时会报ModuleNotFoundError: No module named tkinter。这个问题在M1/M2芯片的Mac上尤其常见ARM架构下需要确认你的Python是用Homebrew装的而不是直接从官网下的那个版本。2.3 安装过程中的高频报错与处理办法安装阶段你大概率会遇到下面几个问题我把最常见的报错信息和解决方案整理成表方便你排查报错提示原因处理方法ModuleNotFoundError: No module named PyQt5缺少界面依赖库pip install pyqt5No module named requests缺少网络请求库pip install requestscommand gcc failedLinux缺少编译环境sudo apt-get install build-essential运行时提示找不到libGL.so.1系统缺少OpenGL库sudo apt-get install libgl1-mesa-glx双击图标没反应Windows下启动路径有问题使用命令行labelImg启动并查看报错这些报错其实都不可怕可怕的是报错之后你不知道去哪查。我的经验是凡是安装阶段的问题优先看英文原版README里面关于依赖的说明是最准确的。国内很多博客年代的软件版本已经过时了照抄反而容易出错。3. 界面功能全解析从打开到出第一批标注安装只是热身真正拉开差距的是你对这个工具细节的把控。我第一次用labelImg的时候因为不了解快捷键和自动保存机制多点了上千次鼠标后来想想真是冤枉。3.1 主界面关键区域逐一看labelImg打开后界面布局是典型的三段式最上面是菜单栏和工具栏左边是主画布区右边是标注列表和文件列表。这个界面初次看会觉得简陋但它每个区域都有明确分工。菜单栏里的Open Dir用来选择图片文件夹Change Save Dir用来指定标注文件生成的目录。注意这里有个很多人不知道的小技巧如果你不点Change Save Dir标注文件会默认保存到和图片同一个目录如果点了则保存到你指定的目录。我习惯把标注文件放在单独的Annotations文件夹里这样即便后期图片需要移动也不会担心混进一堆XML文件。画布区支持鼠标滚轮缩放同时按住Ctrl滚动可以微调缩放比例。标注列表展示当前图片中所有已经画好的框文件列表展示当前文件夹里所有图片的文件名你点击任意一个文件名就会立刻跳转到对应图片。这三块区域配合起来操作效率是很高的。3.2 画框和打标签的基础操作标注的基本流程是打开图片目录设置保存目录然后在画布上从目标左上角按住鼠标拖到右下角松开后弹出类别输入框填写类别名按回车确认。就这么简单但有几个细节直接影响你的标注质量。第一画框的时候尽量贴着物体的边缘。很多人为了省事框的范围比物体宽了10%这在目标检测里属于标注不精准最终会拉低模型的mAP值。第二类别名称必须统一一个项目里不要出现同一物体的两种叫法比如“person”和“people”应该统一成一种不然模型会当作两个类别去学。第三如果是一张图片里的同一个物体有多个实例要一个一个都标出来不要漏。3.3 快捷键列表与效率飞升实操真正让labelImg效率起飞的是快捷键。我建议你把下面这些快捷键记在脑子里能让你每天省下至少半小时的无效操作快捷键功能使用场景W开始画框画矩形、调整位置D 或 A切换到下一张/上一张图片连续标注时刷图CtrlS保存标注画完一张立即保存CtrlD复制当前框到下一张相似目标场景快速复制Delete删除选中框画错了直接删CtrlZ撤销上一步操作误操作后恢复 和 -放大/缩小图片观察小目标细节实际标注时我通常左手放在键盘上右手握鼠标。左手负责W键画框、D键翻页、CtrlS保存右手只管框选目标整套流程下来一张图上五个目标大约只需要20秒。如果你用自动保存模式也就是在View菜单里勾选Auto Saving那么画完一个框后会立刻保存到磁盘完全省去了按CtrlS的动作。4. 核心功能细节格式切换、自动保存与文件管理热词里有“labelimg标注工具切换正方形框不生效”和“labelimg闪退”这两个问题我都在实际项目中碰到过属于比较典型的“看着不严重但极其影响心情”的故障我单开一节说清楚。4.1 为什么快捷键W画正方形框没反应这个问题其实不是bug而是labelImg的快捷键设定逻辑造成的。在我用过的版本里画框是快捷键W键而画正方形框是ShiftW。很多人习惯了快捷键W想画正方形的时候仍然只按W自然不生效。加上Windows环境下输入法状态的影响如果处于中文输入模式Shift键会被输入法吃掉导致组合键识别失败。如果你确实需要画正方形框正确操作是先按Shift然后按W接着在画布上拖动鼠标。画出来的矩形会被强制锁定为正方形这个功能在标注圆形零件、正脸头像这类目标时特别好用。用完之后要切回普通矩形框再按一下W就可以恢复自由比例。还有一个小细节如果发现键盘快捷键全部失效先不要怀疑软件出了问题检查一下右下角输入法状态。把输入法切到英文模式快捷键立马恢复。这个坑至少浪费过我十分钟后来我把系统默认输入法直接设置成英文模式问题彻底杜绝。4.2 保存格式的切换VOC与YOLO的取舍在labelImg里通过菜单栏PascalVOC和YOLO两个选项来切换输出格式。网页上很多教程把这俩写成了两个功能看得人一头雾水其实就是两种格式的切换入口。PascalVOC格式XML文件存储的是目标框在原始图片像素坐标系中的左上角坐标和右下角坐标这种格式直观、可读性强适合调试时查看。YOLO格式TXT文件存储的是归一化后的中心点坐标和宽高也就是把xywh都缩放到0到1之间训练YOLO系列模型时效率更高。我的经验是如果你后续要用Ultralytics的YOLOv8训练推荐直接选YOLO格式如果你还需要做检测结果的二次处理或者和其他框架对接PascalVOC更稳妥。两种格式之间可以随意切换需要提醒的是当你修改了图片的尺寸比如从1920x1080改成640x640那么XML里的坐标不会自动缩放需要你自己重新框选。我自己习惯在项目最开始就把所有图片统一成固定尺寸避免后期返工。4.3 为什么labelImg总是闪退以及怎么防闪退这个问题是我在多个不同版本里都遇到的。经过排查最常见的诱因有三个。第一是图片路径中有中文。labelImg底层依赖Qt5Qt5在Windows环境下对中文路径的处理并不友好一旦图片路径或者保存目录包含中文闪退概率极高。解决办法就是所有数据集相关路径全部用英文不要带空格不要带中文这个习惯我从一开始就养成了。第二是图片格式问题。有些相机会生成特殊编码的JPG或者高动态范围的PNGlabelImg自带的图像读取库可能解析不了。遇到这种文件正确的做法不是去修改labelImg源码而是先用Python的OpenCV库把异常图片转成标准格式import cv2 def convert_image(input_path, output_path): img cv2.imread(input_path) if img is not None: cv2.imwrite(output_path, img, [cv2.IMWRITE_JPEG_QUALITY, 95])第三条是系统内存不足。当你一次性加载一个几千张图片的文件夹时labelImg虽然不会全部载入内存但它在切换图片时的资源回收机制并不高效。如果系统内存小于8G建议一次只标注一个子文件夹比如分成500张一批这样几乎不会触发闪退。如果闪退已经发生最快的恢复办法是重新打开labelImg并检查最近保存的标注文件是否完整。正常情况下只要打开过Auto Saving每个XML或TXT文件都会在画框完成后自动写入所以最多丢失最后一张图的最后一个框损其实可控。5. 实战流程与避坑指南标一批数据要经历什么东西讲再多不去实操一遍等于白看。这一节我以“用labelImg标注一批工业零件缺陷数据”为例把这个项目的完整流程走一遍。这部分内容你完全可以复用到其他场景。5.1 准备数据目录与预检开工之前先把数据目录结构定下来。我推荐下面这种布局dataset/ ├── images/ │ ├── 001.jpg │ ├── 002.jpg │ └── ... ├── labels/ └── classes.txt把图片全部扔进images目录然后打开labelImg点击左侧打开目录选择images点击更改保存目录选择labels接着在右边文件列表里随便点一张图确认能正常显示。这一步相当于体检如果你能顺利完成说明环境和路径都没问题可以开工。5.2 批量标注与质量自检流程标注的过程不需要多说了就是画框、打标签、翻页。但在批量标注时建议每标完成150张左右就停一下做一个自检打开对应的XML目录用文本编辑器随机抽查5个XML文件确认坐标数值没有明显异常类别名称统一标注数量与图片目测吻合。这个自检动作能帮你尽早发现系统性错误而不是等标完全部数据再回头返工。如果你想加速标注我教你一个常用技巧如果图片序列是连续视频帧先用labelImg手动标注第1帧和第10帧然后用方向键快速翻页凭借目视比较你会发现中间帧的目标框往往只需要微调就能复用。因为视频帧里的目标位移是渐变的labelImg会自动继承上一张的标注框吗不会但它提供了复制功能CtrlD可以把上一帧的标注框复制到当前帧你只需要拖动到新位置就行。5.3 多人协同标注时的文件合并如果你是一个人做项目这部分可以跳过。但如果团队分工比如两个人各标一半图片最后需要合并数据集这时就要注意一个坑labelImg输出的XML文件名与图片名完全一致但如果两个人用的是不同机器Windows下可能出现同名文件大小写不一致的情况在后续合并时Linux系统上就会产生重复。我的做法是让两个人在各自标注前先把图片文件名统一加上前缀比如A_xxx.jpg和B_xxx.jpg这样合并后就不可能冲突。6. 还要具备的延伸技能与经验总结最后这部分我想聊一些不那么基础、但对你提升标注效率很关键的技能。这些经验都不是官方文档里能翻到的属于“踩坑踩出来的心得”。6.1 用Python批量检查和修复标注文件标注完几百上千张图之后最怕出现的问题往往是全局性的比如某个类别的名称多打了个下划线或者某些XML文件坐标超出了图片边界。手动检查根本不现实这时候最好写一个小脚本扫一遍。下面这段代码可以检查YOLO格式的TXT文件中的坐标是否越界import os def check_yolo_labels(img_dir, label_dir): for img_file in os.listdir(img_dir): if img_file.endswith((.jpg, .png)): txt_file os.path.join(label_dir, img_file.replace(img_file.split(.)[-1], txt)) if not os.path.exists(txt_file): print(f缺少标注文件: {txt_file}) continue with open(txt_file, r) as f: for line in f: parts line.strip().split() if len(parts) ! 5: print(f格式错误: {txt_file}: {line}) else: x, y, w, h map(float, parts[1:5]) if x - w/2 0 or x w/2 1 or y - h/2 0 or y h/2 1: print(f坐标越界: {txt_file}: {line}) print(检查完成)这种自动化检查脚本算是给标注工作上了一道保险至少不用肉眼逐条核对。6.2 把labelImg嵌入你的个人标注流水线虽然labelImg本身功能单一但你可以通过脚本把它嵌入到复杂的流水线里。比如我用FastAPI写过一个内部工具上传一批图片到服务器服务器自动把图片存到指定目录然后返回一个标注任务ID我用labelImg在本地标注完以后再写脚本把标注文件上传回服务器完成归档。这个流程看起来多此一举但在团队协作里非常管用它让数据有了统一的出入口。另外一个好用的组合是labelImgcv2标注前用OpenCV写个脚本批量处理图片尺寸和格式保证所有图片都能被labelImg正常打开。标注完再写一个格式转换脚本把XML转成json或者把txt转成coco格式这样整个数据准备环节就完全封闭环了。6.3 核心使用方法总结新手必看说了这么多最后帮新手把最关键的几条使用方法浓缩一下。安装就两条命令conda建环境加pip安装打开以后先选图片目录再选保存目录画框快捷键是W保存是CtrlS翻页是D和A标签名称统一路径不能有中文格式选YOLO还是VOC看你后续训练框架YOLOv5/8就选YOLO其他框架一般选VOC。我见过不少人因为觉得labelImg界面简陋一开始就放弃结果绕了一圈用了各种大型工具后又回来了。工具的价值在于解决问题而不在于看起来多高级。至少在我的项目里labelImg始终是那个最不会掉链子的备胎同时也是最顺手的同路人。本文还有配套的精品资源点击获取