Lang::setLocale() 必须在语言包加载前调用，否则lang()仍返回原语言；需手动Load对应语言文件，注意分组、路径、中间件顺序及Cookie配置一致性。
Lang::setLocale() 必须在语言包加载前调用
很多人在 API 接口里写 Lang::setLocale('en-us') 后立刻调用 lang('error_token')，结果还是返回中文或原 key。这不是缓存问题，而是语言环境变更后，框架没重新加载对应语言包——LoadLangPack 中间件只在请求初期执行一次，后续手动切语言不会自动触发重载。
实操建议：
- 显式调用
Lang::load(app()->getAppPath() . 'lang/en-us.php')，确保目标语言文件被 include - 若用了分组（如
validate.php），得连带加载：Lang::load(app()->getAppPath() . 'lang/en-us/validate.php') - 不要依赖
Lang::get('key')自动 fallback 到其他语言包，它只查当前 locale 下已加载的文件 - CLI 或异步任务中，
LoadLangPack不生效，必须手动setLocale+load两步都走
GET 参数 lang=en-us 不生效？检查 detect_var 和中间件顺序
URL 带 ?lang=en-us 却没切换成功，大概率是 detect_var 配置没对上，或者 LoadLangPack 没启用。TP6 的语言侦测逻辑硬编码在中间件里，不启用就完全不解析 GET。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- config/lang.php 里写了
'detect_var' => 'l'，但 URL 传的是lang=en-us→ 不匹配，直接跳过 -
app/middleware.php没加'think\middleware\LoadLangPack'→ 整个语言侦测链路被跳过 - 自定义中间件放在
LoadLangPack之前，且提前终止了请求（如权限拦截返回 JSON）→ 语言设置根本没机会运行 - 用了多应用模式（如
app/api/），但app/api/middleware.php里漏配中间件 → 仅该应用失效
API 返回错误文案仍是英文？验证器语言包没加载对
验证失败时 $validate->getError() 返回英文，不是框架 bug，是你把翻译写在了 zh-cn.php 里，但验证器默认只加载 validate.php。
使用场景：TP6 验证器内置规则（require、email 等）的语言键固定为 validate.required 这类格式，必须存在对应语言分组文件。
实操建议：
- 在
app/lang/zh-cn/validate.php中定义：return ['required' => '不能为空', 'email' => '邮箱格式不正确']; - 确保
config/lang.php的extend_list包含该路径，例如：'zh-cn' => [app()->getAppPath() . 'lang/zh-cn/validate.php'] - 字段级提示要写成
'user_email.email' => '邮箱格式不对'，不能只写'email'—— 验证器会拼接字段名 - 如果用
Validate::make()静态调用，需手动Lang::load()，它不走中间件自动加载
Cookie 切换语言后刷新仍中文？think_lang Cookie 未被识别
前端执行 document.cookie = "think_lang=en-us; path=/;"，但接口响应还是中文，说明框架没读到这个 Cookie，或读到了但没生效。
原因和解决点：
-
config/lang.php中'use_cookie' => false或'cookie_var' => 'lang'和实际 Cookie 名不一致 → 必须严格匹配 - Cookie 的
path不是/，导致跨子路径（如/api/v1）无法读取 → 前端设 Cookie 时务必加; path=/; - HTTPS 站点下设置了非 Secure Cookie → 浏览器直接丢弃，后端收不到 → 前端要用
Secure标志 - TP6 默认从
$_COOKIE['think_lang']读，但某些代理或 Nginx 配置会过滤下划线变量 → 改用短横线命名（如think-lang）更稳妥
最易被忽略的一点：语言切换不是原子操作。Lang::setLocale() 只改当前请求上下文，不影响 session、cookie 或数据库存储；如果你靠 cookie 控制语言，又在控制器里手动 setLocale 覆盖，却忘了同步更新 cookie，下次请求就会回退到旧值。
