### Python `imaplib` 库中文本内容编码转换的方法 在使用 `imaplib` 和 `email` 模块处理电子邮件时，可能会遇到邮件正文或附件名称的编码问题。这是因为不同的邮件客户端可能采用不同的字符集（如 UTF-8、GB2312 或 ISO-8859-1）。为了正确显示这些内容，需要对文本进行解码和重新编码。 以下是具体的操作方法： #### 1. 邮件内容的解码 当从 IMAP 服务器获取邮件内容时，通常会以字节流的形式返回。如果邮件正文中包含非 ASCII 字符，则需要先将其解码为字符串形式。可以通过以下方式完成此操作： ```python import email from email.header import decode_header def decode_text(encoded_text, default_charset='utf-8'): try: decoded_bytes = encoded_text.decode(default_charset) return decoded_bytes except UnicodeDecodeError: # 尝试其他常见编码 for charset in ['gbk', 'iso-8859-1']: try: decoded_bytes = encoded_text.decode(charset) return decoded_bytes except UnicodeDecodeError: continue return encoded_text.decode(errors='replace') # 替换无法识别的字符 ``` 对于邮件头部（如主题、发件人等），可以使用 `email.header.decode_header()` 方法来逐步解析其编码[^2]。 ```python def parse_email_headers(msg): subject = "" if msg["Subject"]: header_tuples = decode_header(msg["Subject"]) subject_parts = [] for text, encoding in header_tuples: if isinstance(text, bytes): if encoding: subject_parts.append(text.decode(encoding)) else: subject_parts.append(text.decode()) else: subject_parts.append(text) subject = ''.join(subject_parts) from_ = email.utils.parseaddr(msg.get("From"))[1] return {"subject": subject, "from": from_} ``` #### 2. 处理邮件正文 邮件正文可能由多个部分组成，尤其是 HTML 和纯文本混合的情况。下面展示了如何提取并解码每部分内容： ```python def extract_body(payload): content_type = payload.get_content_type() content_disposition = str(payload.get("Content-Disposition")) if content_type == "text/plain" and "attachment" not in content_disposition: body = payload.get_payload(decode=True).decode(payload.get_content_charset(failobj="utf-8"), errors='replace') return body elif content_type == "text/html": html_body = payload.get_payload(decode=True).decode(payload.get_content_charset(failobj="utf-8"), errors='replace') return html_body return None ``` #### 3. 完整示例代码 将以上逻辑组合起来，形成完整的解决方案如下所示： ```python import imaplib import email from email.header import decode_header def fetch_emails(host, username, password): mail = imaplib.IMAP4_SSL(host) mail.login(username, password) mail.select("inbox") status, messages = mail.search(None, "ALL") message_ids = messages[0].split() emails = [] for id_ in message_ids[:10]: # 只取前10封作为演示 res, msg_data = mail.fetch(id_, "(RFC822)") raw_email = msg_data[0][1] msg = email.message_from_bytes(raw_email) headers = parse_email_headers(msg) bodies = [] if msg.is_multipart(): for part in msg.walk(): body = extract_body(part) if body: bodies.append(body) else: body = extract_body(msg) if body: bodies.append(body) emails.append({"headers": headers, "bodies": "\n".join(bodies)}) mail.logout() return emails def parse_email_headers(msg): subject = "" if msg["Subject"]: header_tuples = decode_header(msg["Subject"]) subject_parts = [] for text, encoding in header_tuples: if isinstance(text, bytes): if encoding: subject_parts.append(text.decode(encoding or "utf-8", errors='replace')) else: subject_parts.append(text.decode("utf-8", errors='replace')) else: subject_parts.append(text) subject = ''.join(subject_parts) from_ = email.utils.parseaddr(msg.get("From"))[1] return {"subject": subject, "from": from_} def extract_body(payload): content_type = payload.get_content_type() content_disposition = str(payload.get("Content-Disposition")) if content_type == "text/plain" and "attachment" not in content_disposition: body = payload.get_payload(decode=True).decode( payload.get_content_charset(failobj="utf-8"), errors='replace' ) return body elif content_type == "text/html": html_body = payload.get_payload(decode=True).decode( payload.get_content_charset(failobj="utf-8"), errors='replace' ) return html_body return None ``` 上述代码实现了登录到 IMAP 服务端、读取消息以及解析邮件头和主体的功能[^3]。 --- ###