PHPMailer 发送 HTML 邮件时，邮件客户端展示源码而不是渲染效果，这个问题的核心往往不在邮件客户端，而在发信之前 PHP 脚本对邮件格式的设置。HTML 邮件是否被识别，取决于 MIME 头中的 Content-Type 是否为 text/html；如果这一步没做对，内容哪怕写得再标准，也会被当成纯文本处理，所有尖括号自然原样暴露。下面从最常见的原因开始，逐个说明修复方式。
忘记调用 isHTML(true) 是最典型的原因
PHPMailer 默认会把 Body 中的内容当作纯文本发送，内部的 ContentType 初始值是 text/plain。如果不做任何设置，直接把拼好的 HTML 字符串赋给 Body，那么邮件到达收件箱后，所有标签都会以源码形式呈现，因为邮件客户端收到的是纯文本 MIME。解决这个问题最直接的办法，就是在 send 之前调用一次 isHTML(true)。这个方法的本质就是修改 PHPMailer 实例的 ContentType 属性，把它从 text/plain 改成 text/html，这样客户端才知道要按 HTML 渲染。
很多朋友在本地用浏览器打开模板文件一切正常，但通过 PHPMailer 发出去就变成了一堆源码，其实就是少了这一行配置。下面是一个错误示例和修复后的代码对比。
// 错误示例：未启用 HTML 模式 $mail = new PHPMailer(true); $mail->Body = '<h1>你好</h1><p>这是一段正文</p>'; $mail->send(); // 收件箱会显示 <h1>你好</h1> 这样的源码 // 正确示例：启用 HTML 模式 $mail = new PHPMailer(true); $mail->isHTML(true); // 关键配置，不能漏 $mail->Body = '<h1>你好</h1><p>这是一段正文</p>'; $mail->send();
如果模板内容还需要嵌入图片，或者希望 PHPMailer 自动处理相对路径和 inline images，可以使用 msgHTML 方法。msgHTML 内部会自动调用 isHTML，并且能读取 HTML 文件、识别 img 标签并转为内嵌附件。前提是模板文件的路径要正确，且文件内容必须是完整的 HTML 结构。
$mail = new PHPMailer(true); $mail->msgHTML(file_get_contents(__DIR__ . '/template.html'), __DIR__); $mail->AltBody = '这是一封 HTML 邮件，如果您的客户端不支持 HTML，请查看纯文本内容'; $mail->send();
模板读取与变量替换中的隐性错误
还有一种情况是：已经调用了 isHTML(true)，但邮件正文仍然出现源码。这时需要检查模板读取和变量替换的流程。很多人习惯用 file_get_contents 读取 .html 文件，然后直接赋给 Body，这个思路本身没有问题，但问题可能出在后续的变量替换上。为了避免用户输入破坏邮件格式，有人会对整个模板执行 htmlentities 或 htmlspecialchars，结果把模板里本来就存在的 HTML 标签也一起转义了。邮件客户端收到的内容就变成了 <div> 这样的实体，显示出来自然就是源码。
正确的做法是：模板整体保持原样，只对插入模板的用户数据做单独的转义处理。例如用户名、邮箱、用户填写的留言等内容，在替换进模板之前用 htmlspecialchars 处理，而不要对整个模板文件做实体转换。下面是一个比较稳妥的模板读取和替换示例。
$template = file_get_contents(__DIR__ . '/mail_template.html');
$username = '张三';
$message = '你好，这是一条来自用户的留言。';
$body = str_replace(
['{{username}}', '{{message}}'],
[htmlspecialchars($username, ENT_QUOTES, 'UTF-8'), htmlspecialchars($message, ENT_QUOTES, 'UTF-8')],
$template
);
$mail->isHTML(true);
$mail->Body = $body;
$mail->AltBody = "你好 {$username}，这是纯文本版本。留言：{$message}";
$mail->send();
另外要注意，模板文件不要使用 PHP 代码片段，也不要用 include 或 require 去加载邮件模板。这些方式会执行模板中的 PHP 代码，可能造成安全风险，而且当模板里含有 PHP 标签时，输出结果可能被 PHP 解析器修改，进而导致渲染异常。使用纯静态 HTML 文件配合占位符替换是最稳妥的方式。
检查 Content-Type 与 CharSet 配置
即使已经调用了 isHTML(true)，有些情况下仍然会看到源码，这时候需要排查脚本里有没有后续操作覆盖了 ContentType。例如某些代码会手动设置 $mail->ContentType = 'text/plain'，或者通过 addCustomHeader 增加了一个额外的 Content-Type 头，这些都可能导致最终的邮件头不一致。PHPMailer 本身会维护 ContentType，但如果在 send 之前手动修改，就可能把原本的 text/html 覆盖掉。因此需要检查整个发送流程，确认没有类似赋值。
字符集配置也是值得关注的一环。CharSet 如果不设置为 UTF-8，中文内容可能出现乱码，虽然乱码和源码显示是两种现象，但编码问题有时也会干扰客户端对邮件正文的判断。建议在创建 PHPMailer 实例后，显式设置 CharSet 和 Encoding。
$mail = new PHPMailer(true); $mail->CharSet = 'UTF-8'; $mail->Encoding = PHPMailer::ENCODING_BASE64; // 可选，确保中文不乱码 $mail->isHTML(true); $mail->Body = '<div style="font-family:sans-serif;">你好，世界</div>'; $mail->send();
如果想确认最终发出的邮件头到底是什么，可以在主流邮箱中查看邮件原文。例如 Gmail 中打开邮件后选择显示原始邮件，在头部区域搜索 Content-Type，正常情况应该能看到 Content-Type: text/html; charset=UTF-8。如果这里显示的是 text/plain，那就说明 isHTML 没有真正生效，需要回到代码中检查配置顺序和执行路径。
使用 SMTPDebug 验证发送内容和调试
当代码层面看起来一切正常，但收件箱里仍然显示源码，可以打开 PHPMailer 的调试输出，直接观察实际发送的原始邮件数据。将 SMTPDebug 设置为 2 或 3，PHPMailer 会在页面上打印完整的 SMTP 会话和邮件头信息，从中可以直观看到 Content-Type 和 Body 的内容。
$mail->SMTPDebug = 2; // 0=关闭, 1=客户端与服务器消息, 2=完整消息 $mail->Debugoutput = 'html'; $mail->isSMTP(); $mail->Host = 'smtp.ipipp.com'; $mail->SMTPAuth = true; $mail->Username = 'user@ipipp.com'; $mail->Password = 'password'; $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; $mail->Port = 587; $mail->isHTML(true); $mail->Body = '<h2>测试</h2>'; $mail->send();
调试输出会清楚显示类似 Below is the message to send 的段落，里面包含完整的 MIME 结构。如果发现 Body 中的 HTML 标签被实体化，说明是在赋值之前就被转义了；如果 Content-Type 显示为 text/plain，则说明 isHTML 调用被覆盖或未执行。根据这些信息可以快速缩小问题范围。生产环境中记得把 SMTPDebug 改回 0，避免敏感信息泄露。
还有一种调试思路，是在 send 之前临时打印相关属性，例如 var_dump($mail->Body, $mail->ContentType, $mail->CharSet)。这个方法不需要实际发送邮件，也能客观反映当前实例的状态。把这些基础配置检查到位，HTML 邮件显示源码的问题基本都能解决。