base64解码前必须剥离mime头部和边界标记；需定位空行后有效载荷，截取两boundary间内容，清除content-头行，保留纯base64字符并清理末尾空格/\r，再预处理去除非base64字符、补等号后解码。
Base64解码前必须剥离 MIME 头部和边界标记
直接对整个邮件正文调用 base64_decode 会失败——因为 Base64 数据块前后夹着 Content-Type、Content-Transfer-Encoding、Content-Disposition 等头字段，还有 --boundary_123 这类分隔符。实际有效载荷只占整个段落的一小部分。
实操建议：
- 用
std::string::find定位第一个"\r\n\r\n"（空行），之后才是 body 起始；但注意：有些客户端发的是"\n\n"，需兼容两种换行 - 再向后搜索下一个 boundary（如
--=_" + boundary_value + "_=--或--" + boundary_value），截取两者之间的子串 - 丢弃该子串中所有以
"Content-"开头的行（包括空行后的头字段），只保留纯 Base64 字符（A-Za-z0-9+/=）和换行符 - 最后清理掉 Base64 行末可能混入的空格或
\r（常见于 Outlook 生成的邮件）
别用 std::regex 解析 multipart/mixed 的 boundary
正则在 C++ 中解析 MIME boundary 极易出错：boundary 值本身可含点、下划线、甚至引号，且 RFC 2046 明确允许 boundary 出现在行首、行中、行尾不同位置。用 std::regex 匹配 --boundary 可能误切数据块或漏掉结尾的 --boundary--。
实操建议：
- 手动扫描字节流：遍历字符串，检测是否以
"--" + boundary开头，且其后紧跟\r\n或--或 EOF - 特别检查结尾边界：必须是
--" + boundary + "--"（两个短横结尾），中间边界是--" + boundary + "\r\n" - 避免使用
std::sregex_iterator—— 它无法可靠区分嵌套 boundary 和普通文本中的相似字符串（比如附件名里含--xyz）
Base64 解码函数必须容忍换行与非法字符
真实邮件里的 Base64 往往每 76 字符换行（RFC 2045），还可能夹杂空格、制表符、= 后多出的 \r\n。标准解码器若严格校验格式，会提前返回失败。
实操建议：
- 预处理输入字符串：用
std::remove_if清除所有非 Base64 字符（即不在"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"中的字符），但保留=（填充符） - 检查长度是否为 4 的倍数；不是就补
'='—— 有些邮件客户端省略末尾等号 - 不要依赖第三方库的“strict mode”；自己写解码循环更可控（6 位一组移位拼字节，遇
=提前终止） - 解码后验证输出长度：若原始 Base64 长度为
n，理论明文长度应为n / 4 * 3 - (n % 4 == 0 ? 0 : 4 - n % 4)；偏差超过 1 字节说明预处理有误
附件文件名中文乱码？先看 Content-Disposition 的 charset 参数
附件名常写作 filename*="utf-8''%E4%BD%A0%E5%A5%BD.txt"（RFC 5987）或 filename="=?GBK?B?uLK4xLvKwQ==?="（RFC 2047）。直接读 filename= 后面的值会导致乱码。
实操建议：
- 优先匹配
filename\*=：提取编码名（如utf-8）和 URI 编码内容（如%E4%BD%A0%E5%A5%BD.txt），再做百分号解码 + 指定编码转 UTF-8 - fallback 到
filename=：若存在=?开头的值，按=?charset?B?base64str?=或=?charset?Q?qpstr?=拆解，分别调用 Base64/Quoted-Printable 解码，再转 UTF-8 - Windows 下保存文件前，用
MultiByteToWideChar(CP_UTF8, ...)转宽字符，再传给CreateFileW；Linux/macOS 直接用 UTF-8 路径即可
边界识别和 Base64 预处理这两步最容易被跳过，一上来就 decode 整个段落，结果解出来全是 0xFF 或断断续续的垃圾数据。真实邮件没那么规范，得把“清洗”当第一步，而不是解码。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
