Hoppscotch 多语言支持上手5分钟切好中文界面3个场景讲透原理与贡献【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch队友盯着英文界面试探地问这个按钮是干嘛的你却只能用英文回答这篇讲 Hoppscotch 的国际化i18n能力先把界面切到中文再搞懂语言是怎么被选中的最后学会给项目贡献翻译。你将带走什么学会如何切换界面语言并让选择被浏览器自动记住看懂首次启动时的语言判定顺序与英文兜底逻辑用请求头和变量模拟不同语言环境下的 API 响应掌握改一个词与加一种语言两条贡献路径 快速上手从打开页面到看到中文界面浏览器打开 Hoppscotch 网页版hoppscotch.io进入设置页点击选择语言按钮搜索框输入中文列表立刻过滤点击简体中文界面实时切换关掉页面再打开偏好仍在整个过程没有注册、没有配置文件选择只写进浏览器本地。源码里这个动作由changeAppLanguage完成语言文件按需加载选完即持久化下次启动直接命中所以你只需要手动选一次。 场景一应用如何决定给你看哪种语言有人第一次打开就是中文有人却停在英文差别在哪判定逻辑写在packages/hoppscotch-common/src/modules/i18n.ts里顺序很直白。首次启动的判定顺序先读本地配置里的locale字段没有就取navigator.language你浏览器的语言做前缀匹配——zh-CN命中cnen-US命中en再不行就回落到英文。切换后为什么不用重选你手动选择后语言代码会被写进浏览器本地配置下次启动直接命中第一条规则。旧版带/{lang}/前缀的 URL 也会在路由层被识别并转成同一次写入访问分享链接不会打乱你的语言偏好。 场景二借多语言界面测试 API 的国际化响应界面语言是给你看的API 的语言是给最终用户看的。当测试同学反馈中文响应少了一个字段你可以先在本地复现它。用请求头模拟语言环境多数服务从Accept-Language读语言。在请求的 Headers 面板加一行键Accept-Language值zh-CN发送后核对返回字段的完整性与措辞。用环境变量管理多组语言值频繁在多种语言间切换时新建一个环境定义变量accept_language再把请求头的值写成{{accept_language}}。之后换语言只需一键切换环境不必再手动改头。 场景三英文兜底与从右到左的语言缺词时为什么自动变英文i18n 实例的fallbackLocale被固定为en某个键在语言文件里缺失时界面显示英文原文而不是空白或占位符。所以中文界面里冒出一句英文时第一步是去locales/cn.json搜对应模块的键而不是怀疑版本坏了。阿拉伯语这类 RTL 语言阿拉伯语、希伯来语从右往左书写。languages.json中ar的条目带了dir: rtl布局会随之整体翻转。这正是翻译和真正本地化的差距所在也是新建语言包时容易漏掉的一行。️ 进阶玩法自定义与二次扩展语言文件都在packages/hoppscotch-common/locales/下共 34 个 JSON结构一致顶级键是功能模块叶子值是文案。改语言文件不用碰任何源码JSON 本身就是代码。改一个词打开locales/cn.json定位到模块键改掉值保存。从源码构建的场景需要重新构建才能看到效果线上版本则建议提交修复让所有人一起受益。加一种语言完整流程见仓库根目录的TRANSLATIONS.md核心三步git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cp packages/hoppscotch-common/locales/en.json packages/hoppscotch-common/locales/ky.json复制en.json并翻译键结构保持不动在languages.json追加一条{ code: ky, file: ky.json, iso: ky-KG, name: Кыргызча }提交 PR未完成也可以先提交并说明进度方便他人接力排错速查表现象原因解法切换后个别词仍是英文该键在语言文件中缺失自动回落英文到对应 JSON 补上翻译新语言不出现在列表languages.json与 locales 文件缺一不可代码需一致两处都补齐后重新构建改了 cn.json 看不到变化源码构建未重新打包或线上版本缓存重新构建或用无痕窗口验证切换语言后界面异常JSON 逗号、引号错误导致整个文件解析失败用 JSON 校验工具检查或 git 恢复阿拉伯语界面文字方向错乱语言条目缺少dir: rtl在languages.json补上 rtl 标记写到最后Hoppscotch 的多语言不只是换一套文案34 个语言文件、本地记忆、英文兜底、RTL 支持每一处都对着某位工程师的母语。发现翻译错误或功能问题去项目 Issues 提一条翻译细节想先讨论Discord 社区里很热闹如果你恰好会第二种语言locales目录里总有些键在等你补全【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem Cloud • Web, Desktop CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考