### Python IMAP 下载邮件附件并解决中文文件名乱码 当使用Python通过IMAP协议下载带有中文名称的附件时，可能会遇到编码问题导致文件名乱码。为了正确处理这种情况，可以采用以下方法： 对于接收到的邮件中的每个部分，先判断其是否为附件以及是否有`Content-Disposition`头字段存在[^1]。 如果确实是一个附件，则进一步检查该头部中有关于文件名的信息，并对其进行适当解码。具体来说，在获取到原始字符串形式的内容之后，应该考虑多种可能存在的编码方式来尝试恢复正确的字符集表示。通常情况下，会涉及到Base64编码或者是quoted-printable编码等标准机制之一[^2]。 针对中文文件名的情况，一种常见有效的做法是从`filename*`参数入手，它遵循RFC 2231规范定义的方式指定非ASCII字符组成的文件名；如果没有这个特殊标记的话，则按照传统的方法去查找普通的`filename`属性值，并假设它是经过某种特定编码转换后的结果——比如GB2312或UTF-8这样的常用汉字编码方案[^3]。 下面给出一段示范性的代码片段用于展示如何实现上述逻辑： ```python import email from email.header import decode_header import imaplib import base64 def get_attachment(msg_part): content_disposition = msg_part.get("Content-Disposition") if not content_disposition or "attachment" not in content_disposition.lower(): return None file_name_encoded = None try: # 尝试从 Content-Disposition 获取 filename* params = dict([param.strip().split('=') for param in content_disposition.split(';')]) encoded_param_key = next((key for key in params.keys() if 'filename*' in key), None) if encoded_param_key is not None: charset, _, value = params[encoded_param_key].partition("'") decoded_value = urllib.parse.unquote_to_bytes(value).decode(charset) file_name_encoded = decoded_value elif 'filename' in params: file_name_encoded = params['filename'] if file_name_encoded and (file_name_encoded.startswith('=?') and '?=' in file_name_encoded): file_name_decoded = '' parts = decode_header(file_name_encoded) for part, encoding in parts: if isinstance(part, bytes): if encoding: file_name_decoded += part.decode(encoding) else: file_name_decoded += part.decode() file_name_encoded = file_name_decoded payload = msg_part.get_payload(decode=True) with open(f"./downloads/{file_name_encoded}", "wb") as f: f.write(payload) return {"name": file_name_encoded} except Exception as e: print(e) # 连接到服务器并登录账户 mail = imaplib.IMAP4_SSL(host="imap.example.com", port=993) status, messages = mail.select("INBOX") for i in range(1, int(messages[0]) + 1): res, msg_data = mail.fetch(str(i), "(RFC822)") raw_email_string = msg_data[0][1].decode("utf-8") message = email.message_from_string(raw_email_string) for part in message.walk(): attachment_info = get_attachment(part) if attachment_info: print(f"Downloaded {attachment_info['name']} successfully.") ``` 此脚本展示了连接至IMAP服务器读取收件箱内所有消息的过程，并遍历每封信里的各个组成部分寻找符合条件的附件项加以保存。特别注意到了对不同类型的编码进行了兼容性处理以确保能够准确无误地还原出原本的中文文件名字串[^4]。