如何在imapfilter的Subject搜索中匹配方括号内容？

问题分析 #

• 服务器端搜索：contain_subject('[sometext]')生成的IMAP命令UID SEARCH SUBJECT "[sometext]"之所以匹配不带方括号的sometext，是因为多数IMAP服务器的SUBJECT搜索采用子串模糊匹配，且会将方括号这类特殊字符视为普通匹配符号（或直接忽略其特殊含义），无法实现字面精确匹配。
• 客户端正则匹配：match_subject('%[sometext%]')失效，大概率是因为邮件主题可能经过MIME编码（比如=?UTF-8?B?W3NvbWV0ZXh0XQ==?=），imapfilter的match_subject默认不会自动解码编码后的主题，导致正则无法匹配到原始的方括号字符。

解决方案 #

1. 修正客户端正则匹配（推荐，更可靠） #

先获取邮件的原始主题并解码，再用Lua正则匹配：

-- 定义解码MIME主题的辅助函数
local function decode_subject(subject)
    if not subject then return "" end
    -- 处理MIME编码的主题（适配常见的编码格式）
    local decoded = subject:gsub('=?([^?]+)?([BQ])?([^?]+)?=', function(charset, encoding, text)
        if encoding == 'B' then
            return text:gsub('%x%x', function(c) return string.char(tonumber(c, 16)) end)
        elseif encoding == 'Q' then
            return text:gsub('_', ' '):gsub('=%x%x', function(c) return string.char(tonumber(c:sub(2), 16)) end)
        end
        return text
    end)
    return decoded
end

-- 先通过服务器端缩小候选范围，再本地过滤精确匹配项
local candidates = account1.INBOX:contain_subject('sometext')
local results = {}
for _, msg in ipairs(candidates) do
    local subj = decode_subject(msg:fetch_field('Subject'))
    if subj:match('%[sometext%]') then
        table.insert(results, msg)
    end
end

该方法先利用服务器端搜索缩小候选邮件范围，再本地解码主题后做精确匹配，比全量下载主题更高效。

2. 尝试服务器端精确匹配（仅部分IMAP服务器支持） #

部分IMAP服务器（如Dovecot）支持用引号包裹短语实现精确匹配，可尝试手动构造SEARCH命令：

local results = account1.INBOX:search('SUBJECT "[sometext]"')

注意：此方案依赖服务器的IMAP实现，根据你的测试结果，服务器端存在兼容性问题，因此仅作参考。

3. 现有两步法优化 #

如果坚持使用两步过滤逻辑，可优化候选范围的搜索条件，减少本地处理的邮件数量：

local candidates = account1.INBOX:contain_subject('sometext')
local results = {}
for _, msg in ipairs(candidates) do
    local subj = msg:fetch_field('Subject')
    -- 同时适配编码与未编码的主题格式
    if subj:match('%[sometext%]') or subj:match('=?.*%[sometext%].*?=') then
        table.insert(results, msg)
    end
end

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