Hoppscotch 多语言指南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 的多语言支持覆盖了设置、集合、响应查看等几乎全部界面文案30 多种语言可用。读完这篇你能自己切语言、改语言包也能给新语言添砖加脚不用再猜。先搞懂语言包是怎么加载的Hoppscotch 的界面文案不走 URL 里的语言前缀旧版 Nuxt 路由写法已废弃而是集中在packages/hoppscotch-common/locales/目录下一门语言一个 JSON 文件比如cn.json对应简体中文。语言注册表 languages.json 负责登记每门语言的 code、文件名和 ISO 代码界面里出现的下拉选项就是从这里读的。加载逻辑在 src/modules/i18n.ts选中的语言按需求懒加载当前选择存进浏览器 localStorage刷新后自动读回上次的语言没有存过就按浏览器语言设置匹配全都对不上就回退英文。像阿拉伯语这类右起语言在注册表里带了dir标记排版会自动反向。三条路径按诉求选最短的只想用现成的点右上角头像进设置在 Language 下拉框里选一门语言选择会立刻生效并持久化不用再碰配置文件。想改几个词直接编辑对应语言的 JSON比如packages/hoppscotch-common/locales/cn.json只动你关心的值保持 UTF-8 编码、JSON 合法。本地从源码构建的话改完要重新构建才看得到效果。想新增一门语言工作量较大建议三步走——完整复制en.json作为新文件别只翻一半缺键会显示英文在languages.json里追加条目code与文件名保持一致再提交 PR。流程细节看 TRANSLATIONS.md。放到真实业务里多语言验收怎么做验收一个按地区返回文案的接口时比手动改请求头更省事的做法是把语言参数放进环境新建环境比如中文环境加一个键值对accept_language zh-CN请求 Headers 里写Accept-Language: {{accept_language}}。切换环境就切换了语言维度同一批用例能快速复跑en-US、ja-JP等多个版本响应查看器里的中文、阿拉伯文等字符也能正常显示和检索。{ code: hy, file: hy.json, iso: hy-AM, name: Հայերեն }上面是一个语言注册表条目的完整形态新语言照这个结构追加即可需要右起排版再加dir: rtl。给社区出力的最短路径先翻一下已有的 PR确认没人正在做这门语言有就直接加入现有讨论。从main拉新分支命名随意建议带语言代码在 locales 目录下创建新语言文件。复制en.json全量结构再逐条翻译术语全文统一、文案尽量短别丢占位符。在languages.json注册新语言提交 PR中途翻译没做完也可以先提 PR 求助合并前要补齐。踩坑速查切换后部分文案还是英文 → 该语言没翻到对应键机制上会自动回退英文不是 bug → 找到缺失键补上翻译或先当已知缺失处理。改完语言文件毫无反应 → JSON 语法错一个逗号整个文件加载失败全部回退英文 → 先用 JSON 校验工具过一遍确认 UTF-8 编码。源码构建下改了文件看不到变化 → 语言文件参与构建产物不会热更 → 重新构建或开浏览器无痕窗口排除缓存再验证。分享链接带/{语言代码}/前缀的旧 URL → 新版已废弃路由前缀写法 → 访问时会自动去掉前缀并跳转到同一路径无需手动处理。语言包机制本身已经很轻后续大概率是更多语言补齐以及桌面端与 Web 端配置同步得更顺。发现问题可以用这三个渠道反馈GitHub Issues、Discord 社区、supporthoppscotch.io。觉得这篇有用顺手点个收藏吧。【免费下载链接】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），仅供参考