Python批量修改VOC格式XML标注文件类别名称

沈亦白

发布时间：2026-10-16| 4人浏览过

原创

本文介绍如何利用Python脚本批量修改VOC格式XML标注文件中的目标类别名称。通过分析XML层级结构，使用ElementTree库遍历object节点，根据预设规则批量替换name标签内容，从而节省目标检测数据标注处理时间。

项目场景

在进行目标检测任务时，重新进行数据标注往往耗费大量时间。若能批量修改XML文件中的信息，将显著节省处理时间。下文将详细介绍如何修改标注文件XML中的相关信息。

问题描述

假设有一批已标注好的XML文件，其文件格式如下图所示：

<?xml version='1.0' encoding='us-ascii'?>
<annotation>
	<folder>VOC2012</folder>
	<filename>x0y1115.png</filename>
	<source>
		<database>The VOC2007 Database</database>
		<anotation>PASCAL VOC2007</anotation>
		<image>flickr</image>
	</source>
	<size>
		<width>2233</width>
		<height>2177</height>
		<depth>3</depth>
	</size>
	<segmented>1</segmented>
	<object>
		<name>[1]</name>
		<pose>Unspecified</pose>
		<truncated>0</truncated>
		<difficult>1</difficult>
		<bndbox>
			<xmin>0</xmin>
			<ymin>1115</ymin>
			<xmax>30</xmax>
			<ymax>1145</ymax>
		</bndbox>
	</object>
</annotation>
        }

分析

观察标注文件的层级结构，其顺序为annotation——folder/filename/…/object——name/pose/truncated/difficult/bndbox——xmin/ymin/xmax/ymax。现在需要修改标注目标的类别信息（例如将[1]改为lack），其他信息也可依此逻辑修改。Python代码如下：

解决方案

import os
import os.path
from xml.etree.ElementTree import parse, Element
#批量修改xml中内容
def test():
    path = "./datasets/Annotations/" # xml文件所在的目录
    files = os.listdir(path)  # 遍历文件夹下所有文件名称
    for xmlFile in files:  # 对所有文件进行循环遍历处理
        path1 = "./datasets/Annotations/"+xmlFile #定位当前处理的文件的路径
        newStr = os.path.join(path, xmlFile)

        dom = parse(newStr)  # 获取xml文件中的参数
        root = dom.getroot()  # 获取数据结构

        for obj in root.iter('object'): # 获取object节点中的name子节点（此处如果要换成别的比如bndbox）
            name = obj.find('name').text # 获取相应的文本信息
            #  以下为自定义的修改规则，我这里把文本信息为[1]~[5]的内容改成lack，依次类推
            if name in ['[1]','[2]','[3]','[4]','[5]']:
                new_name = 'lack'
            elif name in ['[6]','[7]','[8]','[9]','[10]']:
                new_name = 'black_point'
            elif name in ['[11]','[12]','[13]','[14]','[15]']:
                new_name = 'crack'
            else:
                new_name = 'Satellite_InkDrop'
            obj.find('name').text = new_name # 修改
        dom.write(path1, xml_declaration=True) # 保存到指定文件
        pass
if __name__ == '__main__':
    test()