本文详解如何使用 Go 的 go-imap 库（推荐 mxk/go-imap）为 IMAP 邮件设置 Deleted 标志并安全执行 EXPUNGE，纠正常见误区（如错误使用 /Deleted 或忽略命令同步机制）。
本文详解如何使用 go 的 `go-imap` 库（推荐 mxk/go-imap）为 imap 邮件设置 `deleted` 标志并安全执行 `expunge`，纠正常见误区（如错误使用 `/deleted` 或忽略命令同步机制）。
在 Go 中通过 IMAP 协议删除邮件，本质是两步原子操作：先标记 Deleted 标志，再执行 EXPUNGE 清理。但许多开发者会遇到“标记无效”或“程序卡死”的问题，根源通常在于两个关键点：
- 标志名称错误：IMAP 标准中删除标志是 Deleted（反斜杠开头、大写 D），而非 /Deleted 或 \Deleted 字符串误写；
- 命令未同步等待完成：Store 和 Expunge 均为异步命令，若不主动驱动客户端接收响应，程序将阻塞或跳过实际操作。
以下是完整、可运行的实践代码（基于 mxk/go-imap v1+）：
import (
"fmt"
"log"
"strings"
"github.com/emersion/go-imap"
"github.com/emersion/go-imap/client"
"github.com/emersion/go-imap/imapwire"
)
// 删除单封邮件（messageID 为 IMAP 消息序号，uint32）
func deleteMessage(client *client.Client, messageID uint32) error {
// 步骤 1：构建序列集（支持单个或多个 ID）
seqSet := new(imap.SeqSet)
seqSet.AddNum(messageID)
// 步骤 2：执行 STORE 命令 —— 关键：使用 "Deleted"（注意反斜杠与大小写）
// 注意：必须用 imap.DeleteFlag 常量或字符串 "Deleted"，不可写作 "/Deleted"
err := client.Store(seqSet, "+FLAGS", []interface{}{imap.DeleteFlag}, nil)
if err != nil {
return fmt.Errorf("failed to set \Deleted flag: %w", err)
}
// 步骤 3：执行 EXPUNGE（仅对当前选中的邮箱生效）
// 注意：EXPUNGE 不接受参数，且必须在 Store 后调用
err = client.Expunge(nil)
if err != nil {
return fmt.Errorf("failed to expunge messages: %w", err)
}
return nil
}✅ 关键注意事项：
- Deleted 是标准系统标志：必须以反斜杠开头、首字母大写，且需作为 []interface{} 元素传入（go-imap v1+ 要求）；
- Expunge 作用域受限：它只清除当前 SELECT/EXAMINE 的邮箱中所有带 Deleted 标志的邮件，不会跨文件夹生效；
- 无需手动轮询 InProgress()：现代 go-imap 客户端（如 emersion/go-imap）的 Store/Expunge 方法默认同步等待完成，避免旧版 mxk/go-imap 中需手动 client.Recv(-1) 的复杂逻辑；
- 批量操作更高效：若需删除多封邮件，复用同一 SeqSet 添加多个 ID（如 seqSet.AddNum(1, 5, 10)），减少网络往返。
⚠️ 补充提醒：
- 某些邮箱（如 Gmail）默认禁用 Deleted 的物理删除行为，需配合 AutoExpunge 设置或改用 MOVE 到 [Gmail]/Trash 文件夹；
- 生产环境务必添加超时控制（如 client.SetTimeout(30 * time.Second)）并检查 client.Logout() 是否成功释放连接。
掌握 Deleted 标志的正确语法与命令生命周期管理，是构建健壮 IMAP 邮件处理服务的基础。始终优先使用官方维护的 emersion/go-imap（当前主流标准库），而非已归档的 mxk/go-imap。
