图片标注工具LabelImg使用教程

### LabelImg 工具简介 LabelImg 是一款基于 Python 和 Qt 的图形化图像标注工具，主要用于创建矩形框标注（bounding box），广泛应用于计算机视觉领域中的目标检测任务。它支持导出为 Pascal VOC XML 格式或其他常见格式的数据集文件。 --- ### 安装 LabelImg #### 1. 新建虚拟环境 为了防止依赖冲突，建议先创建一个新的 Python 虚拟环境并激活[^2]： ```bash # 创建虚拟环境 (venv) python -m venv labelimg_env # 激活虚拟环境 source labelimg_env/bin/activate # Linux/MacOS labelimg_env\Scripts\activate # Windows ``` #### 2. 安装 LabelImg 可以通过 pip 或源码方式安装 LabelImg。以下是两种常见的安装方法： - **通过 pip 安装** ```bash pip install labelimg ``` - **通过源码编译安装** 如果需要自定义功能或最新版本，可以从 GitHub 上克隆项目并手动构建[^3]： ```bash git clone https://github.com/tzutalin/labelImg.git cd labelImg # 安装依赖项 pip install pyqt5 lxml # 编译资源文件 make qt5py3 # 执行程序 python labelImg.py ``` --- ### 启动与使用 LabelImg #### 1. 启动 LabelImg 完成安装后，可以直接运行以下命令启动软件[^1]: ```bash labelImg ``` 如果是从源码安装，则执行 `python labelImg.py` 即可。 #### 2. 基本操作流程 - **加载图片**: 点击菜单栏的 “Open Dir”，选择包含待标注图片的文件夹。 - **设置保存路径**: 点击 “Change Save Dir” 设置标签文件存储位置。 - **切换类别**: 在左侧下拉列表中选择当前对象所属类别。 - **绘制边界框**: 鼠标左键拖拽绘制矩形框，覆盖目标区域。 - **保存标注**: 绘制完成后点击键盘上的快捷键 Ctrl+S 或者点击菜单栏的 “Save”。 更多高级功能可通过官方文档进一步学习。 --- ### 示例代码片段 以下是一个简单的脚本用于验证 LabelImg 是否正常工作以及查看其默认配置参数： ```python import subprocess def check_labelimg(): try: result = subprocess.run(['labelImg', '--version'], capture_output=True, text=True) print(f"LabelImg Version: {result.stdout.strip()}") except FileNotFoundError: print("Error: LabelImg is not installed or the command 'labelImg' is not recognized.") check_labelimg() ``` --- ### 注意事项 在实际应用过程中需要注意以下几点： - 图片分辨率应适配模型输入尺寸，过低可能导致标注精度下降。 - 对于大规模数据集，推荐批量处理以提高效率。 ---