如何为PNG、JPG文件添加自定义MetaData

TagLib本身的设计目标是处理音视频格式的元数据，对静态图像格式的元数据写入支持非常有限，无法直接用它完成JPG、PNG的自定义元数据写入，需要按照两类图像的格式标准选择对应方案操作。

两类格式的元数据存储规则 #

操作前需要先明确两种格式的元数据存放逻辑，避免随意修改文件内容导致文件损坏：

• JPG：自定义元数据可以存放在EXIF扩展字段，或XMP标准元数据块中。不建议占用EXIF标准预留的字段ID，长文本、非英文内容优先存放在XMP的自定义命名空间下，兼容性更好。
• PNG：元数据统一存放在文件头的文本类数据块中，共三类可用块：tEXt仅支持ISO-8859-1编码的纯文本，zTXt存压缩后的文本，iTXt支持UTF-8编码和多语言内容。自定义元数据优先选iTXt块存储，避免非英文字符乱码。

落地实现方式 #

根据你使用的技术栈选择对应依赖即可，不需要强行基于TagLib做二次开发：

C++栈（和原有TagLib使用环境匹配） #

• JPG场景：用libexif处理EXIF字段读写，用exempi处理XMP自定义块写入，操作时先读取原文件全量元数据，合并自定义字段后再写回，避免覆盖原有拍摄参数、版权等信息。
• PNG场景：直接用libpng操作iTXt数据块即可，自定义字段的键名建议加专属前缀（比如你的应用名），不要和PNG标准预定义键（Title、Author、Description等）重名，避免和其他软件写入的字段冲突。

Python快速实现示例 #

如果需要快速验证功能，可以用Pillow库完成读写，核心代码如下：

from PIL import Image
from PIL.PngImagePlugin import PngInfo

# PNG写入自定义元数据
with Image.open("input.png") as im:
    meta = PngInfo()
    # 写入自定义键值对，第三个参数控制是否压缩文本
    meta.add_text("MyApp:UserTag", "自定义元数据内容", zip=False)
    im.save("output_with_meta.png", pnginfo=meta)

# JPG写入自定义元数据（XMP方式）
with Image.open("input.jpg") as im:
    # 按XMP规范拼接自定义字段内容
    xmp_payload = b'<x:xmpmeta xmlns:x="adobe:ns:meta/"><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description rdf:about="" xmlns:myapp="http://local.myapp/"><myapp:CustomData>自定义内容</myapp:CustomData></rdf:Description></rdf:RDF></x:xmpmeta>'
    # 写回时保留原有EXIF数据，追加自定义XMP
    im.save("output_with_meta.jpg", exif=im.getexif(), xmp=xmp_payload)

操作注意事项：

• 所有写入操作必须先读取原文件已有元数据做合并，禁止直接写入空元数据块，否则会丢失原文件的所有元信息
• JPG的EXIF单字段有长度限制，超过1KB的自定义内容不要存在EXIF中，统一放到XMP块
• PNG写入中文、emoji等非ASCII内容时，必须使用iTXt块，不要用tEXt块，否则会出现不可逆的乱码

内容的提问来源于stack exchange，提问作者Mehmet Ceylan