应优先使用 mb_decode_mimeheader() 自动解码 MIME 编码邮件主题，若失败再手动解析编码标识并用 mb_convert_encoding 或 iconv 转换为 UTF-8，同时注意清除 BOM、设置响应头与数据库连接编码。
确认邮件主题的原始编码格式
IMAP 协议中，中文邮件主题通常采用 MIME encoded-word 格式，形如 =?GB2312?B?xxx?= 或 =?GBK?B?xxx?=。不能仅凭肉眼判断是 GB2312 还是 GBK —— 实际中绝大多数标为 GB2312 的邮件，真实编码其实是 GBK（兼容 GB2312 且支持更多汉字）。直接用 iconv("GB2312", "UTF-8", $str) 容易截断或报错，应优先尝试 GBK。
使用 mb_decode_mimeheader 解码（推荐首选）
PHP 内置函数 mb_decode_mimeheader() 可自动识别并解码 MIME 编码的主题，无需手动拆分、判断编码类型，且默认支持 GBK/GB2312/UTF-8 等常见编码：
- 确保已启用
mbstring扩展（PHP7.1 默认开启） - 调用前设置内部编码：
mb_internal_encoding('UTF-8'); - 直接传入原始主题字符串：
$decoded = mb_decode_mimeheader($raw_subject); - 结果即为 UTF-8 编码的纯文本，可直接输出或存库
手动解析 + iconv / mb_convert_encoding 回退方案
若 mb_decode_mimeheader 返回空或异常（如含非标准编码标识），可手动提取编码信息后转换：
- 用正则匹配编码声明：
if (preg_match('/=\?([^\?]+)\?([BbQq])\?(.+?)\?=/i', $raw_subject, $m)) { $charset = $m[1]; $encoding = $m[2]; $data = $m[3]; } - 对 base64 编码内容解码：
$decoded_data = ($encoding === 'B' || $encoding === 'b') ? base64_decode($data) : quoted_printable_decode($data); - 转为目标编码（重点）：
• 若$charset是GB2312或GBK，统一用：mb_convert_encoding($decoded_data, 'UTF-8', $charset)
• 或更稳妥：iconv($charset, 'UTF-8//IGNORE', $decoded_data)（忽略非法字节）
避免 BOM 和输出干扰
解码后的 UTF-8 字符串若用于网页展示或 JSON 输出，需注意：
立即学习“PHP免费学习笔记（深入）”；
- 检查是否含 BOM（
\xEF\xBB\xBF），可用ltrim($str, "\xEF\xBB\xBF")清除 - 输出到 HTML 前确保响应头正确：
header('Content-Type: text/html; charset=utf-8'); - 若存入数据库，确认连接层已设 UTF-8：
mysqli_set_charset($conn, 'utf8mb4');
