如何用Python通过imaplib直接移动邮件至指定文件夹？

原生imaplib方案排查与修复 #

你的代码返回OK但实际未移动邮件，可从以下几点排查修复：

1. 确认目标文件夹的准确名称
   不同IMAP服务器的文件夹命名存在差异，尤其是Gmail的特殊文件夹，可通过LIST命令获取真实路径：

# 列出所有文件夹，确认目标文件夹的正确名称
resp, folders = self.connexion.list()
for folder in folders:
    print(folder.decode())

比如Gmail英文环境下垃圾邮件是[Gmail]/Spam，中文环境会是UTF-7编码的[Gmail]/&U,BTFw-，需严格使用LIST返回的准确值。

2. 确保选中源文件夹并正确使用UID
   SEARCH命令返回的UID仅对当前选中的文件夹有效，需先切换到源文件夹再执行搜索：

# 切换到源文件夹（示例为收件箱）
self.connexion.select("INBOX")
# 使用UID SEARCH而非普通SEARCH，确保获取全局唯一ID
ok, uids = self.connexion.uid("SEARCH", None, "ALL HEADER From 'test_bot'")
mail_ids = uids[0].decode().split()

if mail_ids:
    # 执行MOVE命令
    resp_code, response = self.connexion.uid("MOVE", mail_ids[0], "[Gmail]/Spam")
    # 验证移动结果
    self.connexion.select("[Gmail]/Spam")
    ok, target_uids = self.connexion.uid("SEARCH", None, f"UID {mail_ids[0]}")
    print(f"目标文件夹中是否存在该邮件: {bool(target_uids[0].decode())}")

3. 兼容不支持MOVE命令的服务器
   若服务器不支持RFC 6851定义的MOVE命令，可采用COPY + DELETE的原子性替代方案：

self.connexion.select("INBOX")
ok, uids = self.connexion.uid("SEARCH", None, "ALL HEADER From 'test_bot'")
mail_ids = uids[0].decode().split()

if mail_ids:
    # 复制到目标文件夹
    resp_copy, _ = self.connexion.uid("COPY", mail_ids[0], "[Gmail]/Spam")
    if resp_copy == "OK":
        # 标记邮件为删除并永久移除
        self.connexion.uid("STORE", mail_ids[0], "+FLAGS", "\\Deleted")
        self.connexion.expunge()

更简便的替代库方案 #

使用imap_tools库（需先安装：pip install imap-tools），它封装了IMAP操作细节，移动邮件更直观：

from imap_tools import MailBox, AND

# 登录邮箱，指定初始文件夹为源文件夹
with MailBox('imap.gmail.com').login('你的邮箱地址', '应用授权码', initial_folder='INBOX') as mailbox:
    # 筛选来自test_bot的邮件
    for msg in mailbox.fetch(AND(from_='test_bot')):
        # 移动邮件到目标文件夹
        mailbox.move(msg.uid, '[Gmail]/Spam')

注：Gmail用户需开启IMAP服务，若开启两步验证，需使用应用授权码而非登录密码。

内容的提问来源于stack exchange，提问作者Killian Jallais