ThinkPHP多语言邮件需手动注入语言变量，因异步/命令行环境无请求上下文导致lang()不可用；应主动加载语言包并传入翻译后字符串至模板，避免运行时调用lang()。
ThinkPHP 多语言邮件不是靠框架自动联动的，必须手动把语言包内容注入到邮件模板里——否则 lang() 在邮件渲染上下文里根本不可用。
邮件模板里直接调用 lang() 会报错
ThinkPHP 的 lang() 函数依赖当前请求上下文（think\Request 和 think\facade\Lang 初始化），而邮件发送通常在命令行、队列或异步任务中执行，此时没有 HTTP 请求生命周期，lang() 无法自动加载对应语言包，直接调用会返回空或触发 Undefined index 错误。
- 邮件模板（如
view/mail/welcome.html）是纯 PHP 渲染，不走控制器中间件，Lang::detect()不会自动运行 - 即使你在控制器里设置了
Lang::setLocale('en-us')，发邮件时若没显式传入 locale，仍默认用配置里的default_lang - 模板中写
{:lang('welcome_message')}→ 渲染结果为空，且无任何 warning 提示，极难排查
view() 渲染邮件时手动传入语言变量
最稳妥的做法是：在发送逻辑中提前读取语言包，把翻译后的字符串作为变量传给模板，绕过运行时 lang() 调用。
- 先确定目标语言，比如从用户数据库字段读取
$user->lang，或从缓存/参数获取：$locale = $user->lang ?: 'zh-cn' - 用
Lang::load()主动加载对应语言包：Lang::load(APP_PATH . 'lang/' . $locale . '.php'); - 再用
Lang::get()提取内容，组装为数组传入：view('mail/welcome', ['title' => lang('email_welcome_title'), 'body' => lang('email_welcome_body')]) - 模板内直接输出变量：
<h1>{$title}</h1> <p>{$body}</p> <p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p>，不依赖任何运行时语言检测
多语言邮件模板建议用内联 CSS + 纯 HTML 结构
邮件客户端对 CSS 支持极差（特别是 Outlook、Apple Mail），外部样式表、<style></style> 标签基本被过滤，lang() 返回的 HTML 片段若含 class 或 div 嵌套，容易被截断或错位。
- 所有样式必须写在
属性里，避免使用 Flex/Grid - 优先用
<table> 布局，兼容性最稳 <li>语言变量只用于纯文本内容（标题、段落、按钮文字），不要传带 HTML 的翻译项（如 <code>'click_here' => '<a href="#">点此</a>'），防止 XSS 或解析失败 - 中文和英文模板长度差异大，按钮文案要预留足够宽度，比如英文 “Confirm your email” 比中文 “验证邮箱” 长近一倍
- 投递任务时必须塞入关键上下文：
MailJob::dispatch(['user_id' => 123, 'locale' => 'ja-jp']) - 不要依赖
Lang::getLangSet()，它返回的是配置默认值，不是用户真实偏好 - 若用户语言存在变更（比如后台修改了语言设置），队列任务应设计成「延迟投递 + 实时查库」，而不是「投递时快照语言」
- 测试时务必模拟命令行环境：
php think queue:work --once，确认语言变量能正确渲染
队列中发多语言邮件必须显式传递 locale
如果用 think-queue 异步发信，$job->handle() 执行时已脱离原始请求，session、cookie、input() 全部失效，仅靠用户 ID 查库再取语言设置是唯一可靠方式。
真正麻烦的不是怎么切换语言，而是邮件发送路径脱离了 Web 请求链路后，所有“自动感知”机制都失灵了——你得亲手把语言、用户、模板三者在代码里焊死，少一个环节，收件人收到的就是乱码或空白邮件。
