lang()函数不自动翻译，仅按当前语言环境查表取值；“自动”实为手动维护多语言包+触发切换逻辑，常见失败原因包括语言包未加载、路径错误、含bom编码或缓存未刷新。
lang() 函数本身不自动翻译，它只是按当前语言环境查表取值。所谓“自动翻译”，本质是手动维护多语言包 + 合理触发语言切换逻辑。
lang() 调用失败的常见原因
不是函数写错了，而是语言包根本没加载或没匹配上：
-
lang('welcome')返回空或原键名（如welcome），大概率是当前语言包里没定义这个键 - 语言包路径错误：必须放在
lang/zh-cn.php或lang/en-us/lang.php这类约定路径下，不能随意放 - 文件编码含 BOM：PHP 会把 BOM 当作输出，导致语言包解析失败，用 UTF-8 无 BOM 格式保存
- 缓存未刷新：修改了
zh-cn.php但页面还是旧内容？执行php think clear:cache清除运行时缓存
如何让语言切换真正“自动”生效
ThinkPHP 不会凭空猜用户想看哪种语言，它的“自动”依赖明确的优先级链：
- URL 参数最高优先级：
?l=en-us（由VAR_LANGUAGE配置决定）→ 立即写入 cookie 并生效 - Cookie 次之：
think_language存在且在LANG_LIST列表内 → 直接采用 - HTTP_ACCEPT_LANGUAGE 最后兜底：只取第一个语言标签（如
zh-CN,zh;q=0.9→ 解析为zh-cn），且必须在LANG_LIST中才加载
注意：LANG_AUTO_DETECT 必须为 true，否则第三步直接跳过。
API 场景下语言切换怎么传参
前后端分离项目中，前端通常不走 URL 参数传 l=en-us，而是靠请求头或固定参数：
- 推荐方式：在请求 header 中加
X-Language: en-us，然后自定义中间件读取并调用Lang::setLang($lang) - 兼容方式：所有 API 接口统一接受
lang字段（如 POST body 或 query），控制器开头校验并设置：Lang::setLang($request->param('lang', config('app.default_lang'))) - 禁止行为：在 API 响应里返回重定向（302）去改 URL 参数——API 客户端不处理跳转，语言不会变
lang() 和 Lang::get() 的实际差异
表面一样，底层行为有区别：
-
lang('key')是助手函数，会先尝试从当前语言包取值，取不到再 fallback 到默认语言包（如果开启） -
Lang::get('key')是门面调用，严格按当前已设置的语言环境查，不 fallback；适合你明确知道上下文语言、且要求强一致性的场景 - 两者都不支持嵌套变量替换（如
'hello {name}'→lang('hello', ['name' => 'Tom'])在 TP6+ 需要额外扩展，原生不支持）
语言包里键名大小写敏感，'Welcome' 和 'welcome' 是两个不同键 —— 这点容易被忽略，尤其跨团队协作时命名不统一。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
