Node.js用imap库解码含德语变音符号的UTF-8邮件主题失败求助

你遇到的是邮件主题的RFC 2047 Q编码解码问题，自行编写的解码方案因处理逻辑不匹配导致德语变音符号乱码。

错误原因 #

你的代码使用decodeURIComponent处理Q编码内容，但decodeURIComponent是用于解码URI编码字符串的工具，而Q编码中的=XX是直接对应UTF-8的字节值，两者处理逻辑不兼容，最终导致乱码。

正确解码方法 #

方法一：纯Node.js内置API实现（无需额外依赖） #

通过Buffer直接处理二进制字节，还原正确的UTF-8字符串：

const encodedSubject = "=?UTF-8?Q?GMX_T=C3=A4=C3=9Ft?=";

// 剥离RFC2047的编码标识部分
const qEncodedContent = encodedSubject.replace(/^=\?UTF-8\?Q\?|\?=$/g, '');
// 替换Q编码中的下划线为空格，再将=XX转换为对应字节
const decodedBuffer = Buffer.from(
  qEncodedContent.replace(/_/g, ' ').replace(/=([0-9A-Fa-f]{2})/g, (_, hex) => {
    return String.fromCharCode(parseInt(hex, 16));
  }),
  'binary'
);
// 转换为UTF-8字符串
const decodedSubject = decodedBuffer.toString('utf8');

console.log(decodedSubject); // 输出：GMX Täßt

方法二：使用邮件处理库（更简洁） #

如果项目已引入邮件相关库，比如mailparser，它内置了RFC2047解码功能：

const { decodeHeader } = require('mailparser');

const encodedSubject = "=?UTF-8?Q?GMX_T=C3=A4=C3=9Ft?=";
const decodedSubject = decodeHeader(encodedSubject)[0].value;

console.log(decodedSubject); // 输出：GMX Täßt

内容的提问来源于stack exchange，提问作者Flo