thinkphp的lang()函数不支持直接传参替换，仅返回静态字符串；需用{key}占位符配合str_replace手动替换，复数语法item|items除外但仅限count隐式解析。
ThinkPHP 的多语言变量替换本身不支持直接传参式语法（比如 lang('welcome', ['name' => '张三'])），它默认只做静态键值映射。真要实现带参数的动态翻译，得靠占位符 + 手动替换，而不是指望框架自动解析数组参数。
lang() 函数不接受参数数组，只认字符串键
lang() 和 __('key') 都是直接查语言包数组返回字符串，内部不做任何格式化或插值。即使你写 lang('welcome', ['name' => 'Tom'])，第二个参数会被忽略——函数签名里根本没有定义接收参数的形参，PHP 也不会报错，只是静默丢弃。
- 语言包中写
'welcome' => '欢迎 {name}！'是合法的，但框架不会自动替换{name} - 模板里用
{:lang('welcome')}输出的永远是原始字符串欢迎 {name}！，不是“欢迎 张三！” - 想让占位符生效，必须自己调
str_replace()或preg_replace()做二次处理
正确做法：用 {name} 占位符 + str_replace 手动替换
ThinkPHP 官方文档提过 {name} 语法，但它只是约定，不是内置功能。真正干活的是你写的替换逻辑。
- 先用
lang('welcome')拿到带占位符的字符串，比如"欢迎 {name}！" - 再用
str_replace(['{name}'], [$userName], lang('welcome'))得到最终结果 - 如果占位符多（如
{name}、{date}、{count}），建议用数组批量替换：str_replace(array_keys($data), array_values($data), lang('msg')) - 注意大小写和括号必须完全一致：
{Name}≠{name}，[name]不会被识别
复数语法 item|items 是特例，但也不传参
item|items 这种写法是 ThinkPHP 对复数形式的硬编码支持，仅用于数字量词场景，且不依赖函数参数传入数字，而是靠上下文中的 count 键隐式判断。
- 语言包里写
'apple' => '一个苹果|{count}个苹果' - 调用时仍只需
lang('apple', ['count' => 5])—— 注意：这里传数组不是给lang()用的，而是给框架内部复数解析逻辑看的 - 但这个机制只对
|分隔的复数结构有效，不适用于任意占位符，也不支持嵌套或条件表达式 - 如果
lang()返回值里没有|，传数组毫无作用
别把 Cookie 切换和变量替换混为一谈
很多人卡在「切了语言但变量没变」，其实是两件事：语言包加载是全局请求级的，而变量替换是单次字符串操作。Lang 中间件只决定 lang('xxx') 查哪个文件，不负责内容渲染逻辑。
-
Lang::set('ja-jp')只改当前请求的语言标识，不影响已取出的字符串 - 如果你在控制器里先
$text = lang('hello')，再Lang::set('en-us')，$text不会变 - Cookie 写错键名（比如用了
lang而非think_lang）会导致语言包压根没切换，但lang()仍会返回默认语言的内容，看起来像“替换了没生效” - 最隐蔽的坑：语言包路径大小写错误，比如写了
lang/zh-CN/common.php，但框架只认小写zh-cn，结果始终 fallback 到默认语言，你还以为是变量问题
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
