搜索运算符
每个搜索运算符的取值、示例,以及它目前在 App 中是否能进行筛选。
运算符由名称、冒号和值组成,中间没有空格:from:anna。运算符名称不区分大小写。包含空格的值需要加引号:subject:"annual report"。语法页面介绍了如何组合运算符。
参考
“状态”一栏说明该运算符目前在 macOS、iPhone 和 iPad 上的 App 中的作用。
- 可用:按描述进行筛选。
- 受限:可以筛选,但有注明的限制。
- 仅限命令行:只在 foldmail 命令行中筛选,在 App 中不筛选。
- 无效果:会被接受,但不会被评估。搜索的运行方式就像该运算符不存在一样。
- 错误:搜索会停止,并显示一条消息。
| 运算符 | 值 | 示例 | 状态 |
|---|---|---|---|
from: | 发件人的名称或地址 | from:anna | 可用 |
to: | “收件人”中的名称或地址 | to:[email protected] | 可用 |
cc: | “抄送”中的名称或地址 | cc:ben | 可用 |
bcc: | “密送”中的名称或地址 | bcc:ben | 受限:密送没有单独索引,因此实际搜索的是“收件人”栏 |
subject: | 主题中的文本 | subject:invoice | 可用 |
body: | 邮件中的文本 | body:contract | 受限:收到的邮件的正文尚未被索引 |
in: | 文件夹名称或路径 | in:"Archive 2025" | 无效果;在 Mac 上请使用 搜索范围: 栏 |
account: | 账户名称或地址 | account:Work | 仅限命令行 |
from-account: | 账户名称或地址 | from-account:Work | 仅限命令行;与 account: 相同 |
from-identity: | 身份或别名 | from-identity:support | 无效果 |
is: | unread、read、flagged、answered、deleted、draft | is:unread | 可用;其他任何值都会被视为标签,因此 is:Important 等同于 label:Important |
label: | 标签名称 | label:important | 可用;匹配完整的标签名称,不区分大小写 |
has: | attachment | has:attachment | 错误:“尚不支持此搜索运算符。 (has:attachment)”。其他值会被拒绝 |
size: | 比较符、数字、单位 | size:>10M | 可用 |
before: | 日期或相对日期 | before:2024-06-01 | 可用 |
after: | 日期或相对日期 | after:7d | 可用 |
list: | 邮件列表 ID | list:swift-evolution | 无效果 |
file: | 附件的文件扩展名 | file:pdf | 无效果 |
预定义的智能文件夹带附件使用 has:attachment,目前会显示同样的错误。
大小
size: 比较的是服务器报告的整封邮件的大小。可使用 >、>=、<、<= 或 =;不带比较符时,大小必须完全一致。K、M 和 G 分别代表 1,024、1,048,576 和 1,073,741,824 字节;不带单位时,数字以字节为单位。
size:>10M
size:<=500K
size:>=1G
日期
before: 和 after: 接受两种形式:
YYYY-MM-DD格式的日历日期,按 UTC 午夜解读。before:2024-06-01查找 2024 年 6 月 1 日之前的邮件;after:2024-06-01查找从 2024 年 6 月 1 日起(含当天)的邮件。- 从现在往回计算的数字加单位:
d表示天,w表示周,m表示月,y表示年。after:7d查找过去七天的邮件,before:6m查找所有早于六个月的邮件。
其他形式(例如 before:2024-06)不是日期,会因解析错误而使搜索停止。FOLD 比较的是邮件头中的日期;如果邮件头中没有日期,则比较服务器的到达日期。
after:2024-01-01 before:2024-04-01
before:1y size:>5M
排除
目前,在运算符前加减号只对状态值有效,例如 -is:read。对于其他运算符,减号要么导致错误,要么被忽略;详情见语法页面。
无效果的运算符
仅由无效果的运算符组成的查询(例如 in:INBOX 或 list:announce)会匹配每一封邮件。在过滤规则中请注意这一点,因为在那里,这样的条件会作用于所有邮件。
示例
from:anna subject:budget after:30d
from:[email protected] -is:flagged
(from:anna OR from:ben) is:flagged
label:project-x before:3m