ThinkPHP 8.2 多语言需手动注册路径、设默认语言并显式调用翻译函数，否则返回空或原键名；须在 config/app.php 配置 lang_path、default_lang 和 support_lang，语言包按 ISO 639-1 命名，置于指定目录并确保 runtime/lang/ 可写。
ThinkPHP 8.2 的多语言不是靠「启用某个开关」就生效的，必须手动注册语言包路径、设置默认语言、并在控制器/模板中显式调用 lang() 或 __()，否则所有翻译函数返回空字符串或原始键名。
确认语言包目录结构和加载路径
TP8.2 默认不自动扫描语言文件，必须在 config/app.php 中明确声明 lang_path 和支持的语言列表。常见错误是把语言包放在 app/lang/zh-cn/ 却没告诉框架去哪找。
- 语言包应按 ISO 639-1 标准命名子目录，如
zh-cn、en-us、ja-jp，每个目录下放message.php（数组返回键值对） - 在
config/app.php中补全配置：'lang_path' => app_path() . 'lang' . DIRECTORY_SEPARATOR, 'default_lang' => 'zh-cn', 'support_lang' => ['zh-cn', 'en-us', 'ja-jp'],
- 若语言包放在
runtime/lang/或自定义路径，lang_path必须是绝对路径，且 Web 进程有读取权限
在控制器中切换语言并验证是否生效
TP8.2 的语言切换不依赖 Cookie 或 Session 自动识别，必须主动调用 think\facade\Lang::setLocale()，且该调用需早于任何 lang() 调用，否则缓存已生成，切换无效。
- 在控制器构造函数或前置中间件中设置：
use think\facade\Lang; Lang::setLocale('en-us'); - 切勿在视图里用
Lang::setLocale()，因为模板渲染时语言环境已冻结 - 验证是否加载成功：在控制器中加一行
dump(Lang::has('user.login'));，返回true表示键存在；若为false，检查message.php是否返回数组、键名是否拼写一致、文件编码是否为 UTF-8 无 BOM
模板中使用 __() 函数的注意事项
__() 是 TP8.2 的快捷翻译函数，但它不支持动态变量拼接——比如 __('Hello %s', $name) 在 8.2 中会直接输出原始字符串，而非替换。
立即学习“PHP免费学习笔记（深入）”；
- 正确写法是用
sprintf()手动包裹：<?= sprintf(__('Hello %s'), $name) ?> - 若启用了多语言路由（如
/en-us/login），需配合Route::domain()或中间件提取语言段，并在请求生命周期早期完成Lang::setLocale() - 避免在
config/文件中直接调用__()，因为配置加载早于语言环境初始化，必然返回空
最易被忽略的是：TP8.2 的语言缓存默认写入 runtime/lang/，但该目录若不可写，__() 会静默失败且不报错——务必确认 runtime/lang/ 存在且 Web 进程有写权限，否则每次请求都重新解析 PHP 文件，性能断崖下跌。
