Go go-imap 的 Unselect 与带删除标记的退出有什么区别

在 Go 的 IMAP 同步程序里，切换邮箱或结束一次处理时，最容易误解的是“退出当前邮箱”是否等于“提交删除”。go-imap 的 Unselect() 只发送 UNSELECT：释放当前 selected mailbox 的服务端资源，回到 authenticated 状态，但保留带 \\Deleted 标记的邮件；UnselectAndExpunge() 则发送 CLOSE，CLOSE 会静默执行 EXPUNGE，因此会永久移除带删除标记的邮件。

官方地址：https://pkg.go.dev/github.com/emersion/go-imap/v2/imapclient

下面的代码和图示围绕这个差异展开。图示是静态说明图，不代表在本机或某个真实邮箱服务器上执行过。

先看结论：一个是退出，一个是退出并提交删除

这里的“带删除标记”指邮件已经被设置了 \\Deleted 标志，并不代表调用 Unselect() 会自动添加或移除这个标志。真正的选择点是：结束当前 selected 状态时，要不要让服务端执行清理。

Unselect 做了什么

RFC 3691 定义的 UNSELECT 用来关闭当前邮箱而不执行 expunge。go-imap 文档也明确说明，Client.Unselect 要求服务器支持 IMAP4rev2 或 UNSELECT 扩展。调用成功后，连接仍然处于已认证状态，之后可以重新选择另一个邮箱；已经带 \\Deleted 标记的邮件则继续留在邮箱中。

因此，读取任务在发现服务器支持 UNSELECT 时，可以把它当成一种“撤离当前邮箱上下文”的动作。它不会替你确认删除，也不会因为连接暂时离开邮箱就改变邮件的删除标志。

UnselectAndExpunge 为什么会删除邮件

go-imap 的 UnselectAndExpunge 文档写得很直接：它发送 CLOSE；而 CLOSE 会隐式执行一次静默的 EXPUNGE。RFC 3501 对 CLOSE 的定义也是关闭 selected mailbox，并永久删除所有带 \\Deleted 标志的邮件。

这也是它和普通 Unselect() 的核心差别：UnselectAndExpunge() 不是更“彻底”的断开连接，而是把退出当前邮箱与删除提交绑定在一起。只要邮箱里存在已经标记为删除的邮件，调用成功后它们就不再是可恢复的普通邮箱内容。

用一个显式开关封装退出决策

实际项目里，建议把“是否提交删除”变成业务层的显式参数，而不是让调用方直接凭方法名猜测后果：

package mailflow

import (
    "errors"

    "github.com/emersion/go-imap/v2/imapclient"
)

// leaveMailbox 只在调用方明确选择 purge 时提交删除。
func leaveMailbox(c *imapclient.Client, purge bool) error {
    // 没有 selected mailbox 时，两个退出方法都不符合当前状态。
    if c.Mailbox() == nil {
        return errors.New("no mailbox is selected")
    }

    var cmd *imapclient.Command
    if purge {
        // CLOSE 会静默执行 EXPUNGE，永久移除 \\Deleted 邮件。
        cmd = c.UnselectAndExpunge()
    } else {
        // UNSELECT 只释放邮箱资源，不提交删除标记。
        cmd = c.Unselect()
    }

    // Wait 阻塞到服务端完成命令，错误必须回传给上层处理。
    return cmd.Wait()
}

这个封装有三个作用。第一，先检查 c.Mailbox()，避免在没有 selected mailbox 时发送不合适的退出命令。第二，使用 purge 把不可逆操作放到调用点显式表达。第三，等待命令完成并返回错误，避免把“已经提交删除”误当成仅仅切换了会话状态。

怎么根据场景选择

只想暂时离开当前邮箱

例如同步器完成了 INBOX 的读取，准备切换到 Archive，或者一个长连接服务需要释放当前邮箱相关资源但保留后续处理机会，应优先使用 Unselect()。前提是服务器支持 IMAP4rev2 或 UNSELECT 扩展；否则需要根据服务器能力采用项目允许的兼容策略。

已经完成删除确认

只有当上层业务已经确认“带 \\Deleted 标记的邮件应当永久清理”时，才使用 UnselectAndExpunge()。它适合明确的清理任务、归档策略或用户已经提交的删除动作，不适合作为所有会话退出路径的默认值。

无法确认服务器能力或删除意图

这时宁可保守地使用不会触发清理的路径，并把能力协商和删除提交拆开处理。不要用方法名里的 “Expunge” 当作普通关闭的同义词；它告诉你这个调用会触及带删除标记的邮件。

常见问题

Unselect 会取消邮件的 \\Deleted 标记吗？

不会。它只是不执行清理，已经存在的标记仍由服务器保存。

UnselectAndExpunge 会删除所有邮件吗？

不会。它针对带 \\Deleted 标记的邮件执行隐式 EXPUNGE，普通未标记邮件不会因为 CLOSE 而被删除。

为什么调用 Unselect 报服务器不支持？

UNSELECT 不是所有服务器都默认提供的能力。go-imap 文档要求服务器支持 IMAP4rev2 或 UNSELECT 扩展，应用应把能力协商结果纳入退出策略。

小结

Unselect() 的语义是“退出当前 selected mailbox，但保留删除标记”；UnselectAndExpunge() 的语义是“用 CLOSE 退出，并让服务端静默清理 \\Deleted 邮件”。把二者放在不同的业务路径里，退出动作就不会意外变成不可逆的删除提交。