mac上可通过三种方式为文件添加说明文字：一是启用finder预览面板并勾选“允许编辑元数据”后双击评论字段；二是用command+i打开简介窗口在“通用”区域输入评论；三是用终端xattr命令写入私有spotlight元数据，仅当前用户可见。
你在Mac上想让文件自带一段简短说明文字，比如“客户最终确认版”“需法务复核”“已同步至服务器”，又不希望改动文件名或另存为副本，就得用Finder原生支持的“评论”字段——它写入文件元数据，能被Spotlight搜索到，且在预览面板和简介窗口里直接显示和编辑。
开启预览面板并启用元数据编辑权限
默认状态下，Finder右侧预览区只能看不能改。必须先让它变成可点、可输的编辑面板。
按下 Shift + Command + P，确保当前焦点在访达窗口（标题栏高亮），预览面板会从右侧滑出。若无反应，点击顶部菜单栏“显示”→勾选“显示预览”。
接着点击“显示”→“显示预览选项”，勾选【允许在预览中编辑元数据】。这一步不可跳过，不勾选就永远点不动“评论”字段右侧的铅笔图标。
关闭设置窗口，重新选中一个文件，预览面板底部会出现“评论”字段，右侧带铅笔图标——现在可以双击输入了。
通过“显示简介”窗口添加评论（兼容所有macOS版本）
这是最稳妥的方法，哪怕预览面板没开、快捷键失效、或你正用老旧系统，它都管用。
选中目标文件 → 按 Command + I 打开简介窗口。
滚动到底部“通用”区域，找到“评论”字段（位于“标签”下方），直接点击空白处输入文字。
输入完成后关闭窗口即可保存。【注意：此评论对当前用户可见，但不加密，同一台Mac上的其他账户也能通过“显示简介”读取】
用终端命令写入私有评论（仅当前用户可见，不暴露于UI）
当你需要备注内容彻底避开访达界面、Quick Look预览、iCloud同步甚至AirDrop传输时，必须绕过“评论”字段，改用Spotlight专属元数据。
第一步：打开“终端”（访达 → 应用程序 → 实用工具）。
第二步：执行命令：xattr -w com.apple.metadata:kMDItemComment '这是只有我能看见的备注' /路径/到/文件。把“/路径/到/文件”替换成真实路径，例如/Users/alex/Documents/contract_v3.pdf。
第三步：验证是否写入成功 → 输入命令：mdls -name kMDItemComment /路径/到/文件，若返回你刚输入的字符串，说明写入完成。
【Spotlight元数据不会出现在访达任何UI界面，也不会被网络共享、AirDrop或第三方App读取，仅当前用户登录后通过mdls或脚本可访问】
