Python下载JPG图片添加可在Mac Finder显示的评论元数据遇问题

你的操作错误点 #

• 直接操作文件句柄赋值：f['Comments'] = 'Comments'完全错误，_io.BufferedWriter是文件写入流对象，并非字典，不支持键值对赋值逻辑。图片元数据需要写入对应格式的标准元数据字段（比如JPG的EXIF），而非直接操作文件对象。
• 写入JSON破坏图片结构：把JSON内容追加到图片文件末尾会损坏图片格式，而且Mac Finder不会识别这种自定义内容作为评论。

正确实现方法 #

JPG图片的元数据存储在EXIF标准中，Mac Finder的评论同时关联EXIF的UserComment字段和文件的Spotlight扩展属性，以下是两种主流实现方式：

方法1：用Pillow修改图片EXIF元数据 #

Pillow是Python处理图片的常用库，可以直接修改JPG的EXIF字段：

1. 安装依赖：

pip install pillow

2. 完整代码：

import requests
from PIL import Image
from PIL.ExifTags import TAGS

DOWNLOAD_PATH = "/your/download/path"
updated_image_url = "https://example.com/your-image.jpg"
file_name = "test.jpg"
comment_content = "你的评论内容"

# 1. 下载图片到本地
response = requests.get(updated_image_url)
download_path = f"{DOWNLOAD_PATH}/images_test/{file_name}"
with open(download_path, 'wb') as f:
    f.write(response.content)

# 2. 修改EXIF的UserComment字段
image = Image.open(download_path)
exif_data = image.getexif()

# 定位UserComment对应的EXIF标签ID
user_comment_tag = next(k for k, v in TAGS.items() if v == 'UserComment')
# EXIF的UserComment要求UTF-16编码
exif_data[user_comment_tag] = comment_content.encode('utf-16')

# 保存带元数据的图片
image.save(download_path, exif=exif_data)
image.close()

方法2：同时设置Mac Spotlight评论（确保Finder显示） #

如果仅修改EXIF后Finder仍不显示评论，需要设置Mac文件的专属扩展属性com.apple.metadata:kMDItemFinderComment，可通过xattr库实现：

1. 安装依赖：

pip install xattr

2. 添加扩展属性的代码（在下载图片后执行）：

import xattr

# 设置Spotlight评论，确保Finder能直接显示
xattr.setxattr(download_path, "com.apple.metadata:kMDItemFinderComment", comment_content.encode('utf-8'), options=xattr.XATTR_CREATE)

说明 #

• EXIF的UserComment是图片本身的元数据，跨平台通用；Mac的扩展属性是系统专属，仅在MacOS下生效。
• 若修改后Finder未立即显示评论，可右键图片选择「显示简介」，或按Cmd+Option+Esc重启Finder刷新显示。

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