ThinkPHP 8.0 多语言（i18n）切换实现方案【全球化】
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
在ThinkPHP8.0中实现多语言切换，需要关闭allow_url_lang配置，创建全部小写语言包目录及公共函数文件common.php，编写自定义中间件，在handle()开头调用Lang::setLang()设置当前语言，中间件注册顺序为SessionInit之后、路由之前，前端可通过Cookie或请求参数传递语言标识，模板视图使用{:lang()}
在ThinkPHP 8.0里做多语言切换，有个核心的门槛必须要跨过去：语言标识必须在语言包加载之前就生效。否则，你点按钮后 lang('submit') 显示对了，但表单验证报错、系统默认文本，全给你弹回中文——那种割裂感，懂的都懂。
所以，这篇文章就来拆解一下，怎么把这个流程走通，一次搞定。
配置语言开关与基础参数
先打开 config/app.php，确认下面三项已经摆正了位置：
'lang_switch_on' => true—— 注意，必须是布尔值true，不是字符串'true'，这俩区别很大。'default_lang' => 'zh-cn'—— 默认语言，按自己的项目来。'lang_list' => ['zh-cn', 'en-us', 'ja-jp']—— 支持的语言列表，写清楚。
最关键的一步：把 'allow_url_lang' => false 给设上。为什么要关？因为如果开着，别人在 URL 后面加个 ?lang=en-us 就能把你的 Cookie 切换逻辑给劫持了，整个切换策略乱套。一定要关掉。
创建标准语言包结构
在项目根目录下新建 lang/ 文件夹，目录名必须全小写，按语言码来建子目录：
lang/zh-cn/common.php→ 里面写return ['login' => '登录', 'submit' => '提交'];lang/en-us/common.php→return ['login' => 'Login', 'submit' => 'Submit'];lang/ja-jp/common.php→return ['login' => 'ログイン', 'submit' => '送信'];
这里有几个坑，得提前说清楚：
- 文件名必须是
common.php，不是index.php也不是Common.php（大小写敏感）。 - 目录名必须全小写，
ZH-CN或zh_CN都不会被加载，Linux 服务器上直接静默失败——lang('login')会原样返回'login'字符串，不报错、不警告，查都查不到。
编写语言切换中间件
执行命令行：php think make:middleware Lang，生成 app/middleware/Lang.php。
然后在 handle() 方法开头插入这么几行逻辑：
- 解析 Host，去除端口干扰 ——
$host = parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST) ?: $_SERVER['HTTP_HOST']; - 读取用户首选语言 ——
$lang = $request->cookie('think_lang', $request->session('lang', 'zh-cn'));先从 Cookie 读，没有就从 session 拿，再没有就用默认。 - 可选的域名映射覆盖 —— 如果你有
config/lang_domains.php文件，里面配了['en.example.com' => 'en-us']，那就用$lang = $domains[$host] ?? $lang;覆盖一下。 - 立即生效 ——
thinkLang::setLang($lang);这步最重要，必须在语言包被加载之前调用。 - 注册顺序要卡准 —— 把
app\middleware\Lang::class加到app/middleware.php的全局中间件数组里，位置必须在SessionInit之后、路由调度之前。顺序错了，中间件不干活。
前端触发语言切换
前端怎么切换？两种常用方式：
方法一：纯前端写 Cookie（注意键名和路径必须严格匹配）
document.cookie = "think_lang=en-us; path=/; max-age=31536000";方法二：调用后端接口（推荐，避免键名、路径、域名的各种小问题）
fetch('/api/setlang?lang=ja-jp', { method: 'POST' });后端接口里只用一行代码：
cookie('think_lang', $request->param('lang'), ['expire' => 31536000, 'path' => '/']);必须再次强调：Lang 中间件只认 cookie('think_lang')，你改成 lang 或 language 完全无效；而且中间件读取是一次性的，请求进来之后再去改 $_COOKIE 数组是没用的，别踩这个坑。
模板与代码中使用翻译
模板里直接写 {:lang('login')} 或 {__('submit')}；控制器里用 lang('welcome') 或 __('hello')。
验证规则的错误信息会自动跟随当前语言，前提是语言已经在中间件开头设好了。如果验证提示还是中文，排查时重点检查三点：中间件是否注册到位？handle() 开头有没有调用 setLang()？allow_url_lang 是不是 false？这三处对了，基本不会有问题。
WPS Office是一款面向macOS用户的综合办公套件，将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式，支持Intel及Apple芯片Mac，基础功能可免费使用，
Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核，支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换，并可通过账户在多台设备之间同步项目。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Ableton Live 是面向音乐制作人与现场表演者的数字音频工作站，提供编曲视图、独具特色的现场视图、音频录制、MIDI创作、实时变速、乐器及效果器。Mac版原生支持Apple芯片，并可连接音频接口、MIDI控制器和第三方插件。
Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera
Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。
Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。
Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。
Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。
AutoCAD 是 Autodesk 推出的专业计算机辅助设计软件，Windows 版支持精确二维绘图、三维实体与曲面建模、图纸标注、布局发布和任务自动化，并包含多套行业专业化工具组合，适用于建筑、机械、电气、工程建设及制造设计人员。
SketchUp Pro 是面向建筑、室内、景观、施工和产品设计等专业场景的三维建模工具，提供桌面建模、LayOut 二维文档、模型资源库、扩展程序及云端协作能力。其操作逻辑直观，适合从概念推敲、空间规划到图纸表达和方案汇报的完整工作流程。
AutoCAD LT 是 Autodesk 推出的专业二维 CAD 软件，适合建筑师、工程师、施工人员和设计师完成精确绘图、标注及文档编制。它支持 DWG 工作流、智能块、图形比较、计数、表格和 AutoLISP 自动化，
Rhino 3D 是 McNeel 推出的专业三维建模工具，可创建、编辑和分析 NURBS 曲线曲面、实体、网格、SubD 与点云。Windows 版支持精确造型、工程制图、渲染、文件转换及 Grasshopper 参数化设计，
Autodesk Fusion 是面向产品设计与制造的云连接开发平台，在统一环境中整合三维 CAD、CAM、CAE、PCB、工程图、数据管理和团队协作功能，适合产品设计师、机械工程师、电子工程师及加工制造团队完成从概念建模、验证分析到生产交
Archicad 是 Graphisoft 面向建筑师、设计师、工程师及 BIM 团队开发的建筑信息模型平台。它把三维建筑建模、施工文档、数据管理、专业协调、实时协作和可视化集中在统一项目环境中，适合从概念方案到施工交付的完整建筑设计流程。
Vectorworks Architect 是面向建筑师、室内设计师和建筑顾问的综合设计与BIM平台，覆盖概念草图、二维制图、三维建模、施工文档、数据报表、可视化及开放式协作。它强调自由造型与数据化建筑对象并存，
Shapr3D 是一款基于 Siemens Parasolid 几何内核的专业三维CAD软件，可在 Windows 电脑和平板设备上完成草图绘制、实体建模、参数化修改、模型可视化及技术图纸制作。软件提供免费基础方案，
FreeCAD 是面向机械设计、产品开发、建筑建模和创客项目的免费开源参数化三维 CAD 工具。它可在 Windows 上完成约束草图、实体零件、装配、工程图、BIM、有限元分析及 CAM 等任务，
Twinmotion 是 Epic Games 推出的实时三维可视化工具，可导入常见 CAD、BIM 与三维模型，通过材质、环境、植被、灯光及动画资源快速构建场景，并输出图片、视频、全景图和交互演示。
BricsCAD 是以 DWG 为核心格式的专业 CAD 平台，可用于二维制图、三维建模、工程文档与设计协作。产品按 Lite、Pro、BIM、Mechanical 和 Ultimate 等层级提供不同工具，
Ableton Live 是面向音乐创作、录音、编曲、声音设计、混音与现场演出的数字音频工作站。它将适合即兴触发素材的 Session 视图与传统时间线编曲结合，并提供音频变速、MIDI工具、软件乐器、效果器和声音资源，