
本文详解如何使用 Python 的 Pillow 库安全、可靠地读取和写入图像中的 XMP 元数据(如 PreservedFileName、Title 等),弥补其原生 EXIF 接口无法覆盖 XMP 字段的局限,并提供可复用的代码模板与关键注意事项。
本文详解如何使用 python 的 pillow 库安全、可靠地读取和写入图像中的 xmp 元数据(如 `preservedfilename`、`title` 等),弥补其原生 exif 接口无法覆盖 xmp 字段的局限,并提供可复用的代码模板与关键注意事项。
XMP(Extensible Metadata Platform)是现代数字资产管理(DAM)的核心标准,它以结构化 XML 形式嵌入图像文件,支持自定义命名空间(如 xmpMM:PreservedFileName、dc:Title),广泛用于文件重命名备份、版权标识、工作流追踪等场景。但需明确一点:XMP ≠ EXIF。Pillow 的 getexif() 方法仅访问 JPEG 文件中的 EXIF IFD 段(即传统相机参数),对独立存储在 APP1 段内的 XMP 数据完全不可见——这正是你执行 i.getexif().get_ifd(ExifTags.IFD.Exif) 时无法看到 PreservedFileName 的根本原因。
幸运的是,Pillow 自 9.0.0 版本起已内置 XMP 支持(依赖 defusedxml 安全解析器),只需调用 Image.getxmp() 即可获取完整结构化数据:
from PIL import Image
# ✅ 正确读取 XMP(含自定义字段)
img = Image.open("P1050122.jpg")
xmp_data = img.getxmp()
print(xmp_data)
输出为嵌套字典,典型结构如下:
{
'xmpmeta': {
'RDF': {
'Description': [
{
'about': '',
'title': {'Alt': {'li': {'lang': 'x-default', 'text': 'P1050122'}}},
'xmpMM:PreservedFileName': 'P1050122.jpg'
}
]
}
}
}
⚠️ 注意事项:
字段路径需匹配命名空间:
exiftool写入的XMP-xmpMM:PreservedFileName在 Pillow 中对应键名为'xmpMM:PreservedFileName'(冒号前为命名空间缩写),而XMP-dc:Title对应'dc:title'(注意小写);-
写入 XMP 需手动构造并调用
Image.save():Pillow 不提供原地写入 XMP 的 API,必须通过img.info["xmp"] = xmp_bytes注入原始 XML 字节流,再保存文件。推荐使用exiftool批量写入(稳定、兼容性强),或借助xml.etree.ElementTree构造标准 XMP 包:from PIL import Image import xml.etree.ElementTree as ET # 示例:为图像添加 XMP Title(简化版,生产环境建议用 lxml 或 exiftool) def set_xmp_title(filepath, title_text): img = Image.open(filepath) # 构造最小化 XMP XML(实际应用中应严格遵循 XMP 规范) xmp_xml = f'''<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?><xmpmeta xmlns:x="adobe:ns:meta/"><rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><description rdf:about="" xmlns:dc="http://purl.org/dc/elements/1.1/"><title>{title_text}</title></description></rdf></xmpmeta><?xpacket end="w"?>''' # 注入并保存(会重写整个 JPEG 文件,确保备份原图!) img.info["xmp"] = xmp_xml.encode() img.save(filepath, quality=95, subsampling=0) # 保留画质关键参数
✅ 最佳实践建议:
- 读取优先用 Pillow:轻量、无依赖、适合脚本化解析;
-
写入强烈推荐
exiftool:exiftool -XMP:Title="My Title" -overwrite_original file.jpg更安全、支持原子操作、兼容所有 XMP 命名空间(包括xmpMM,photoshop,Iptc4xmpCore等); -
隐私与合规:批量处理前务必验证 XMP 是否含敏感字段(如 GPS、设备序列号),可用
exiftool -G -U -n file.jpg | grep -i "xmp\|gps"快速审计; -
工程化提醒:XMP 是“元数据容器”,不是数据库——避免存储大文本或二进制;关键业务字段(如原始文件名)建议同时写入
XMP-xmpMM:PreservedFileName和XMP-dc:identifier,实现跨工具链互操作。
掌握 XMP 的读写能力,意味着你真正拥有了图像的“数字护照”管理权——从团体照自动化归档到科研图像可追溯发布,每一张图都将承载精准、可信、可审计的结构化身份信息。










