ThinkPHP 6 多语言需手动开启 app.lang_switch_on=true，语言包须严格按 lang/zh-cn/common.php 目录结构存放，动态切换推荐用 Session/Cookie 而非仅 GET 参数，模板中使用前需清除缓存并确保键名完全匹配。
ThinkPHP 6 的 app.lang_switch_on 开关必须手动开启
默认情况下，ThinkPHP 6 并不启用多语言自动切换功能，即使你放好了语言包、设置了 lang 参数，Lang::get() 依然只读默认语言（通常是 zh-cn）。关键就在配置开关没打开。
实操建议：
- 在
config/app.php中显式设置'lang_switch_on' => true - 同时确认
'default_lang' => 'zh-cn'是你期望的 fallback 语言 - 别依赖环境变量或命令行参数自动推导——TP6 不会自己从
Accept-Language头生效，除非你额外写中间件
语言包路径和命名必须严格匹配 Lang::detect() 规则
ThinkPHP 6 的语言包加载不是“找文件夹就行”，它靠 Lang::detect() 解析请求参数 → 推导语言标识 → 拼路径 → 加载 PHP 文件。路径错一个字母、大小写不对、文件后缀不是 .php，都会静默失败。
常见错误现象：
- 访问
/index?lang=zh-hans却还是显示英文 —— 因为语言包实际放在lang/zh-cn/，而zh-hans没对应目录 - 写了
lang/zh-CN/目录但不生效 —— TP6 只认小写短横线格式（zh-cn），不识别大写或下划线 -
lang/zh-cn.php这种单文件写法无效 —— 必须是目录结构：lang/zh-cn/validate.php、lang/zh-cn/common.php
标准路径示例：lang/zh-cn/common.php 内容应为 return ['hello' => '你好'];
动态切换不能只靠 GET 参数，Session 或 Cookie 才可靠
Lang::detect() 默认只检查 GET['lang']、POST['lang']、Cookie[think_lang]、Session[think_lang] 这四个来源，且有固定优先级：GET > POST > Cookie > Session。如果你希望用户选一次语言就记住，光传 ?lang=ja-jp 是不够的。
实操建议：
- 前端点击切换时，用 AJAX 调用接口写入 Session：
session('think_lang', 'ja-jp') - 或者用 JS 设置 Cookie：
document.cookie = "think_lang=ja-jp; path=/;" - 避免在控制器里手动调
Lang::setLocale('ja-jp')—— 它只对当次请求生效，且绕过检测逻辑，后续模型验证等可能仍用默认语言
Lang::get() 在视图中失效？检查模板编译缓存和命名空间
你在模板里写 {:lang('user_not_found')} 却输出原文，大概率不是语言包问题，而是模板缓存没刷新，或语言键名根本没定义。
容易踩的坑：
- 修改了
lang/zh-cn/common.php但页面没变 —— 执行php think clear:template清空模板缓存 - 用了
lang('user_not_found')，但语言包里定义的是'user_not_login' => '请先登录'—— 键名必须完全一致，不支持模糊匹配 - 在扩展类或事件回调里调用
Lang::get()失败 —— 确保该处已初始化语言组件，必要时手动Lang::load(...)
复杂点在于：语言包是按模块/控制器名自动加载的（比如 user.php 对应 UserController），但 common.php 是唯一全局自动加载的。其他文件得自己 Lang::load()，否则 Lang::get() 查不到。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
