ThinkPHP多语言失效主因是Lang中间件未注册、语言包路径错误或Lang::set()未配合Cookie写入；需检查middleware.php配置、确保lang/zh-cn/common.php路径正确、切换时调用cookie('think_lang','en-us')。
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()，框架不会扫进去。这两点查日志不报错，调试时容易绕远路。
