Mac上可通过osxmetadata命令行工具、MetaImage图形软件及Python脚本三种方式添加文件元数据：osxmetadata支持自定义xattr键值（需域名前缀）；MetaImage专用于图像EXIF/IPTC批量编辑；Python脚本结合tag与xattr可批量设置Finder标签和Spotlight评论。
在Mac上给文件添加特定的Meta信息，比如自定义标签、Spotlight评论、作者名、创建者、版权说明等，不是靠右键“显示简介”里填几个字段就能覆盖全部需求的——系统原生界面只暴露了有限字段，且不支持批量、不支持EXIF/IPTC/XMP等专业元数据写入。
用osxmetadata命令行工具添加基础元数据
打开终端，先确认是否已安装osxmetadata：
pip3 list | grep osxmetadata
若无输出，运行 pip3 install osxmetadata 安装。该库直接操作macOS底层扩展属性（xattr），写入结果与Finder标签、Spotlight索引完全同步。
给单个文件添加“项目编号”和“内部评审状态”两个自定义键：
osxmetadata --set com.example.project_id "PRJ-2026-087" --set com.example.review_status "Approved" /path/to/file.pdf
注意：键名必须带域名前缀（如com.example.xxx），否则系统会拒绝写入；【不加前缀将导致命令静默失败，文件元数据无任何变化】。
验证是否成功：
osxmetadata --list /path/to/file.pdf
用MetaImage批量注入图像EXIF/IPTC信息
适用于JPEG/TIFF/PNG等图像文件，需提前下载安装MetaImage for Mac v2.6.4（拖拽至Applications完成安装）。
方法一：图形界面快速编辑
① 启动MetaImage → 将多张图片拖入主窗口 → 左侧边栏切换到“IPTC”标签页。
② 在“Caption”栏输入统一说明文字，在“Copyright Notice”栏填入© 2026 YourName. All rights reserved.。
③ 勾选底部“Apply to all selected files”，点击右下角“Save”按钮。
方法二：用预设模板一键覆盖
点击顶部菜单“File → Load Preset…”，选择已保存的IPTC模板（含摄影师、城市、关键词等12项字段），再点“Apply & Save”。该操作会**覆盖原有IPTC数据，不可撤销**。
用脚本批量设置Finder标签与Spotlight评论
Finder标签（Tag）和Spotlight评论（kMDItemComment）是日常最常调用的两类Meta信息，但系统不提供批量GUI入口。
第一步：准备文本清单
新建一个CSV文件meta_batch.csv，内容格式为：
path,tag,comment/Users/you/Music/Track1.mp3,Mastered,Final mix approved by client/Users/you/Music/Track2.mp3,Review,Needs vocal comp
第二步：运行Python脚本
粘贴以下代码到apply_meta.py并执行：python3 apply_meta.py
import csv, subprocess<br>with open("meta_batch.csv") as f:<br> for row in csv.DictReader(f):<br> subprocess.run(["tag", "--add", row["tag"], row["path"]])<br> subprocess.run(["mdls", "-name", "kMDItemComment", "-raw", row["path"]]) # 先查原值<br> subprocess.run(["xattr", "-w", "kMDItemComment", row["comment"], row["path"]])
注意：此脚本依赖命令行工具tag（用brew install tag安装）和系统xattr；【kMDItemComment写入后需等待Spotlight重新索引（约1–3分钟），期间搜索可能不生效】。
