ThinkPHP发送邮件需确保模板样式内联且字符集为UTF-8、base64编码，多语言须手动加载语言包并传入翻译后变量，禁用运行时lang()调用；推荐Twig引擎替代原生模板，SMTP配置须匹配端口/加密方式并启用调试。

ThinkPHP 发送邮件不是简单调用一个方法就完事，关键在模板渲染方式和发送上下文环境两个环节。直接用 lang() 或外链 CSS 的模板，90% 会出问题——要么乱码、要么空白、要么被当垃圾邮件。

HTML 邮件模板必须内联样式

所有主流邮件客户端（Outlook、Apple Mail、QQ邮箱等）基本不支持 标签或外部 CSS 文件。哪怕你用了 Bootstrap 类名，也得手动转成行内 style。

• 模板路径建议统一放在 view/email/ 下，比如 verify.html
• 渲染时用 $this->fetch('email/verify', ['code' => $code])，不要用 view() 直接输出到浏览器那种逻辑
• 每个标签都得带 style 属性：

  验证码：{$code}

• 务必设置：$mail->CharSet = 'UTF-8'; $mail->Encoding = 'base64';，缺一不可

多语言邮件不能依赖 lang() 函数

邮件常在队列、命令行或定时任务中发送，此时没有 HTTP 请求上下文，lang() 会返回空字符串甚至报错，而且毫无提示。

• 先读取用户语言偏好，比如 $locale = $user->lang ?: 'zh-cn'
• 主动加载语言包：Lang::load(APP_PATH . 'lang/' . $locale . '.php');
• 用 Lang::get('email_verify_title') 提前翻译好，再传进模板：view('email/verify', ['title' => $title, 'body' => $body])
• 模板里只输出变量：

  {$title}

  {$body}

  

  btpanel phpsite 宝塔面板PHP网站

  宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

  下载
  ，不调用任何函数

推荐用 Twig 替代原生模板引擎

ThinkPHP 原生模板对邮件场景支持弱，比如不自动转义 HTML、不强制内联、无变量预编译。Twig 更安全可控，适合纯内容渲染。

• 安装：composer require twig/twig:^3.0
• 封装一个 TemplateService，指定模板目录为 template/email/
• 渲染时传入已翻译的变量：Twig::render('verify.html', ['code' => $code, 'title' => $title])
• Twig 默认转义 HTML，发邮件时用 {{ body|raw }} 输出原始 HTML 内容

SMTP 配置要避开常见坑

别只填账号密码就以为能发——端口、加密方式、时区、字符集，一个错就静默失败。

• QQ 邮箱用 smtp.qq.com + SSL/465，Gmail 用 smtp.gmail.com + TLS/587
• date_default_timezone_set('Asia/Shanghai') 必须设，否则部分服务器时间戳异常导致认证失败
• 附件路径必须是英文，中文路径在 PHPMailer 中大概率丢失
• 开发阶段启用 $mail->SMTPDebug = 2，错误信息会直接打印，比看日志快得多

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！