ThinkPHP多语言“不加载”，90%不是插件问题，而是语言包根本没被读进来——Lang::get() 返回空字符串、翻译失效、切换后还是默认语言，根源几乎都在加载时机、路径结构或中间件注册这三处。
Lang中间件没注册，等于没写多语言逻辑
ThinkPHP的think\middleware\Lang中间件默认不启用，不手动加进配置里，整个语言检测、Cookie读取、包加载流程就跳过。现象是：$_COOKIE[‘think_lang’] 有值，但Lang::getLangSet() 始终返回默认语言，Lang::get() 也拿不到翻译。
打开 app/middleware.php，确认数组里有 think\middleware\Lang::class，且未被注释多应用模式下，必须在对应应用（如 app/admin/middleware.php）中单独配置，全局中间件在多应用里会被覆盖中间件顺序不能乱：它得在 SessionInit 之后、路由调度之前执行，否则读不到 Cookie 或 Session 上下文
语言包路径错一位，就静默失败
ThinkPHP只按固定路径扫描语言包：lang/{lang}/（如 lang/zh-cn/），不是看文件名、也不是读 config/lang.php 里的别名。包里缺 common.php 或目录大小写写成 ZH-CN，都会不报错、不提示、直接回退到默认语言。
确保语言包放在 app/lang/zh-cn/common.php 这类路径下，不是 app/lang/zh-cn.php多应用时，模块级语言包路径为 app/{app_name}/lang/zh-cn/common.php，注意 {app_name} 是实际应用名（如 admin）vendor 扩展的语言包不会自动加载，需手动调用 Lang::load(EXTEND_PATH . ‘pkgname/lang/zh-cn.php’)，路径必须是绝对路径
Lang::set() 不写 Cookie，切换后立刻失效
调用 Lang::set(‘en-us’) 只改当前请求上下文，不碰 Cookie，也不触发重新加载语言包。用户刷新页面，Lang中间件照旧读旧 Cookie（或 fallback 默认语言），导致“切了但没切成功”。
立即学习“PHP免费学习笔记（深入）”；
切换语言时，必须显式写 Cookie：cookie(‘think_lang’, ‘en-us’)，键名必须是 think_lang，不能是 lang 或 language前端 JS 写 Cookie 也要严格匹配键名和 path/domain，否则后端读不到Lang::setLocale() 必须在 Lang 类初始化之后调用（比如控制器里），太早（如 config 加载阶段）会无效
动态字段翻译不能靠语言包硬替换
语言包只适合静态文案（按钮、提示语）。数据库里存的标题、描述等动态内容，得从字段或 JSON 字段里按当前语言取值，不是改 Lang::get(‘title’) 就能解决的。
推荐用 JSON 字段存多语言：{"zh-cn": "首页", "en-us": "Home"}，在模型 accessor 里写 json_decode($this->title, true)[Lang::getLangSet()] ?? ”注意：where 查询、关联预加载、验证规则都不会走 accessor，搜索时得显式拼字段名（如 title_zh）或用 DB::raw() 切换字段别指望语言包自动翻译数据库字段值——那是数据层适配，不是国际化文案层的事
最常被忽略的是：Lang中间件读 Cookie 只在请求初始化阶段做一次，后续手动改 $_COOKIE 完全无效；还有 vendor 包语言文件必须手动 Lang::load()，框架不会扫进去。这两点查日志不报错，调试时容易绕远路。
评论(0)