使用Pillow修改TIF图像标签遇KeyError，求批量处理方案

错误原因分析 #

1. 内存对象未同步更新：保存目标图像后，你直接访问的是保存前打开的targetimg对象，内存中的标签并未同步磁盘上的更新内容，因此读取标签270会触发KeyError。
2. 只读标签对象的修改限制：sourceimg.tag_v2返回的是只读TIFF标签对象，直接修改可能引发异常，需先转为普通字典再编辑。
3. 标签格式不符合规范：部分TIFF标签（如ImageDescription）要求值为字节串，直接赋值字符串可能导致标签未正确写入。

单张图像修复后的代码 #

from PIL import Image

# 打开源图像和目标图像
sourceimg = Image.open("source.tif")
targetimg = Image.open("target.tif")

# 将只读标签对象转为可编辑的普通字典
tiffinfo = dict(sourceimg.tag_v2)

# 修改或添加标签：将字符串转为字节串符合TIFF规范
tiffinfo[270] = "Example image".encode('utf-8')

# 保存目标图像，传入修改后的标签字典
targetimg.save("target_updated.tif", tiffinfo=tiffinfo)

# 重新打开更新后的图像，读取并解码标签内容
with Image.open("target_updated.tif") as updated_img:
    print(updated_img.tag_v2[270].decode('utf-8'))

批量处理方案 #

如果需要处理文件夹内所有TIFF图像，可通过遍历文件实现批量标签复制与修改：

import os
from PIL import Image

# 配置路径参数
source_tif_path = "source.tif"
input_folder = "path/to/your/target_images"
output_folder = "path/to/save/updated_images"

# 创建输出文件夹（不存在则自动创建）
os.makedirs(output_folder, exist_ok=True)

# 读取源图像的基础标签并统一修改
with Image.open(source_tif_path) as source_img:
    base_tiffinfo = dict(source_img.tag_v2)
    # 批量修改目标标签，这里以ImageDescription为例
    base_tiffinfo[270] = "Batch updated image description".encode('utf-8')

# 遍历目标文件夹内的TIFF文件
for filename in os.listdir(input_folder):
    if filename.lower().endswith(('.tif', '.tiff')):
        input_path = os.path.join(input_folder, filename)
        output_path = os.path.join(output_folder, filename)
        
        with Image.open(input_path) as target_img:
            # 保存时传入修改后的标签字典
            target_img.save(output_path, tiffinfo=base_tiffinfo)
            print(f"处理完成：{filename}")

注意事项 #

• 避免直接覆盖原文件：建议将更新后的图像保存到新文件夹，防止原始数据丢失。
• 标签格式兼容性：部分TIFF标签有特定数据格式要求（如整数、列表），修改前需确认对应标签的规范格式。
• 内存优化：处理大量图像时，使用上下文管理器（with语句）自动关闭图像文件，避免内存泄漏。

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