### Python 下载邮件附件时文件名或内容乱码的解决方案 对于Python下载邮件附件过程中出现的文件名或内容乱码问题，主要原因是编码不匹配造成的。具体来说，在处理电子邮件中的非ASCII字符集（如中文）时，如果未正确设置编码，则可能导致乱码现象。 #### 设置正确的编码方式 为了确保能够正确解析带有非ASCII字符的文件名，应当采用合适的编码方式进行转换。通常情况下，使用`utf-8`作为默认编码是一个不错的选择[^1]。然而，某些特定场景下可能还需要考虑其他编码标准，比如针对中国大陆地区的简体中文环境下的`gb2312`编码[^4]。 #### 使用email库读取并保存附件 在实际操作中，可以通过Python内置的`email`库来获取和存储邮件及其附件： ```python import email from email.header import decode_header import os def save_attachment(msg, download_folder="attachments"): if not os.path.exists(download_folder): os.makedirs(download_folder) for part in msg.walk(): if part.get_content_maintype() == 'multipart': continue if part.get('Content-Disposition') is None: continue filename = part.get_filename() if filename: decoded_filename = "" # 处理带有多部分编码的文件名 h = email.header.decode_header(filename) for fragment, encoding in h: if isinstance(fragment, bytes): try: if encoding: decoded_fragment = fragment.decode(encoding) else: decoded_fragment = fragment.decode() except UnicodeDecodeError as e: print(f"Failed to decode {fragment} with {encoding}") continue elif isinstance(fragment, str): decoded_fragment = fragment decoded_filename += decoded_fragment filepath = os.path.join(download_folder, decoded_filename) with open(filepath, "wb") as f: f.write(part.get_payload(decode=True)) ``` 此函数会遍历每封邮件的所有组成部分，并仅保留那些被标记为可附加的内容。它还会尝试解码任何经过编码传输的文件名，从而避免因编码差异而导致的乱码情况发生。 另外需要注意的是，在构建HTTP响应头时也应指定恰当的编码格式以供客户端浏览器识别，例如可以参照如下做法设定响应头部信息[^3]: ```python response.headers["Content-Disposition"] = "attachment;filename*=UTF-8''{}".format(quoted_utf_filename) ``` 这里采用了RFC 5987定义的方式指定了参数值的语言标签以及字符集，使得大多数现代Web浏览器都能够正确理解所附带资源的真实名称。