使用imaplib无法访问收件箱外文件夹，遇IMAP命令执行错误

• 转义IMAP特殊字符：Gmail的[Gmail]文件夹名包含方括号，这是IMAP命令的特殊字符，直接使用会导致SELECT command error: BAD [b'Could not parse command']错误。需要将方括号转义为\[Gmail\]，正确的草稿箱路径应为\[Gmail\]/Drafts。

• 严格遵循IMAP状态流程：SEARCH illegal in state AUTH和CLOSE illegal in state AUTH错误都是因为操作顺序违反了IMAP的状态规则：

  • 必须先通过SELECT命令进入SELECTED状态，才能执行SEARCH、FETCH等针对文件夹内容的操作；
  • 完成操作后，需在SELECTED状态下执行CLOSE，再进行后续的登出或切换文件夹操作。

正确的代码示例：

import imaplib

# 建立SSL连接并登录
imap = imaplib.IMAP4_SSL('imap.gmail.com')
imap.login('your_email@gmail.com', 'your_app_password')  # 注意使用Gmail应用专用密码

# 转义文件夹名并选择目标文件夹
target_folder = r'\[Gmail\]/Drafts'
imap.select(target_folder, readonly=True)  # readonly=True可防止误修改文件夹内容

# 在SELECTED状态下执行SEARCH操作
status, search_results = imap.search(None, 'ALL')

# 处理搜索结果（示例：打印所有邮件ID）
if status == 'OK':
    for num in search_results[0].split():
        print(f"邮件ID: {num.decode('utf-8')}")

# 关闭当前文件夹（需处于SELECTED状态）
imap.close()

# 登出连接
imap.logout()

• 确认准确的文件夹名称：如果仍不确定文件夹路径，可先调用imap.list()获取所有文件夹的完整列表，从中找到目标文件夹的准确名称：

status, folder_list = imap.list()
if status == 'OK':
    for folder in folder_list:
        print(folder.decode('utf-8'))

内容的提问来源于stack exchange，提问作者Abhay Nagar