labelimg

LabelImg 是一款开源免费的图像标注工具，主要用来给图片框选目标并生成训练数据所需的标签文件。它支持 Pascal VOC 与 YOLO 等常见标注格式，可在 Windows、macOS 和 Linux 上运行。界面走简洁路线，配合快捷键能明显加快标注速度，适合目标检测、医学影像分析等需要批量处理图片的场景。是课程项目还是实际开发，都能用它快速产出可用的数据集。

谁适合用它

1、 学生群体：可拿来做课程作业或毕业设计，较快熟悉图像标注的基本流程

2、 研究人员：用于生成目标检测、语义分割等任务所需的训练数据

3、 开发者：能嵌入项目之中，自定义标注流程并做格式转换，对接 Faster R-CNN、YOLO 等模型

主要特点

- 免费开源无版权限制，靠快捷键操作可把标注速度提升约 3 倍，也支持批量处理

- 标注格式可一键切换，自动生成标准标签文件，直接对接训练框架

- 原生支持 Win11、Mac 和 Linux，体积轻、依赖少，低配置电脑也能流畅跑

- 标签列表可自行定义，支持中文显示，适应不同场景的标注需求

安装与配置步骤

- 装 PyQt5：在 cmd 里执行 pip install PyQt5，网络不畅时可能失败；此时手动下载配套 whl 文件，文件名看 Downloading 后面那串，例如 PyQt5-5.8.2-5.8.0-cp35.cp36.cp37-none-win_amd64.whl，下载后执行 pip install XXX.whl。注意所用 pip 要对应 Python3.5 版本，若 pip 有问题需重装 Python3.5

- 装 PyQt5_tools：命令为 pip install pyqt5-tools，同样可能因网络失败，拿到类似 pyqt5_tools-5.8.2.1.0rc2-cp35-none-win_amd64.whl 的文件后手动 pip install 安装

- 装 lxml：执行 pip install lxml，文件较小一般能成功，失败就按同样办法下载 whl 再装

- 编译资源文件：进入解压后的 labelImg-master 目录，执行 pyrcc5 -o resources.py resources.qrc

常见问题处理

1、 启动方式：按 Win+R 打开运行窗口，输入 labelimg 回车即可打开界面

2、 图片加载失败：确认路径不含中文或特殊字符，格式为 JPG/PNG/BMP，关掉中文输入法，以管理员身份启动，清理缓存后重新选择标注文件夹

3、 标注文件存不上：检查输出文件夹是否可读可写，确认没以只读模式打开，关掉占用文件的程序，重新设置保存格式，并更新到最新版

4、 中文标签乱码：把 data/predefined_classes.txt 改成 UTF-8 编码，在界面勾选 View→Auto Save，重启软件，使用已修复该问题的最新版

5、 快捷键无效：确认没被其他软件占用，在 View→Shortcuts 里查看或修改，以管理员身份运行，切到英文输入状态，重启软件重新加载配置