Hoppscotch多语言使用指南：35种界面语言怎么切、怎么改、怎么加

Hoppscotch多语言使用指南：35种界面语言怎么切、怎么改、怎么加

【免费下载链接】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 做 REST 接口测试，第一句话是："这些按钮都是英文，我能换成印尼语吗？"可以。界面语言由 vue-i18n 驱动，语言包按文件懒加载，选择结果存在浏览器 localStorage 而不是后端数据库，所以云端、桌面端、自托管实例行为完全一致，部署方不需要任何额外配置。

读完你可以做到这几件事：

• 切换界面语言，并让某台机器永远用指定语言启动
• 改一个术语、新增一门语言，从文件改到重新构建
• 用请求头和环境变量模拟不同地区用户的 API 调用

界面语言在哪、由谁决定

语言包分两处存放。packages/hoppscotch-common/languages.json是语言清单，每个条目包含语言代码、对应文件、ISO 标准代码，RTL 语言还会多一个"dir": "rtl"标记。packages/hoppscotch-common/locales/下的 JSON 文件才是真正的翻译内容。

启动时加载哪门语言，按三层规则依次兜底：先读本地配置里的locale；没有就看浏览器系统语言navigator.language；再没有就用英文en。

三层都没命中时界面就是英文，这不是 bug，是设计上的兜底。

切换界面语言的3种方式

设置菜单里选

打开设置页，语言区就是一个带搜索框的选择器，输入德或Deutsch都能过滤出来。点中某项后整站文案立即替换，无需刷新。选择器组件在packages/hoppscotch-common/src/components/smart/ChangeLanguage.vue，想研究它怎么实现的可以直接读这个文件。

命令面板里搜

按Ctrl+K（Mac 上Cmd+K）打开命令面板，直接搜"语言"相关命令。适合不想点开设置页的场景。

直接写 localStorage

在浏览器控制台执行：

localStorage.setItem("locale", "cn");

重启应用后生效。适合脚本化场景，比如给测试机预装固定语言环境。

桌面端的设置入口在左下角齿轮图标，位置比 Web 版靠边，别找错了。

怎么固定默认语言

Hoppscotch 没有单独的"默认语言"配置文件。所谓固定，就是把某台设备 localStorage 里的locale设成你希望的代码，之后每次启动都走第一层兜底，直接用这个值。

注意两点：偏好不跟随账号，也不跟随工作区，换设备、换浏览器就得重新设；清掉浏览器站点数据后偏好会丢，会退回系统语言判断。

语言文件长什么样

以英文包为例，顶级键按模块分组：

{ "action": { "add": "新增", "cancel": "取消" }, "auth": { "login": "登录", "logout": "登出" }, "state": { "nothing_found": "未找到" } }

一个包约一千多个键，覆盖动作、认证、状态提示、各类页面文案。缺失的键会自动回退到英文，所以你切换语言后偶尔看到零星英文，多半是那个键还没被翻译，先检查目标语言文件里有没有这个路径，再决定是补翻译还是提反馈。

改术语与新增语言包

只改几个词

直接编辑目标语言的 JSON，比如把cn.json里某个请求相关的词改成团队内部统一叫法，保存后重新构建前端，改动的文案就会替换。

线上部署的是构建产物，改 JSON 不重新构建，界面上什么都看不到变化。

从零加一门语言

以越南语（vi）为例，仓库里还没有这个包，三步走：

1. 复制locales/en.json为locales/vi.json，完成翻译；
2. 在languages.json数组里加一条{"code": "vi", "file": "vi.json", "iso": "vi-VI", "name": "Tiếng Việt"}；
3. 构建项目，语言选择器里立刻多出一项，选中后整站变为越南语。

完整流程细节见仓库根目录的 TRANSLATIONS.md。

用多语言做接口测试

界面语言之外，测试侧还有两个实用点。

Accept-Language 请求头

在 Headers 标签加一行，模拟地区用户的语言偏好：

{ "key": "Accept-Language", "value": "zh-CN,zh;q=0.9" }

发送后响应体里若包含地区化文案，按zh-CN返回，对照测试多地区表现就靠这一行。

用环境变量参数化

在环境里建一个变量accept_language，值填zh-CN，请求头里写{{accept_language}}。之后测"东京用户"还是"柏林用户"，只需要切环境，不用回头改请求。

桌面版连接自托管实例时，工作区和收藏走服务端同步，但语言偏好留在本地，新电脑第一次打开仍按系统语言走，记得手动切换。

参与翻译与下一步行动

翻译提交路径很简单：先翻完目标语言文件，再改languages.json，提交 PR。合并前可以先发半成品 PR 拉人帮忙，TRANSLATIONS.md 里写明了这一点。

下一步你可以：

• 发现某个词翻译别扭或整段漏译：在项目仓库提 issue 或直接发修正 PR
• 想补全一门语言：按上面"从零加一门语言"三步走，参考 TRANSLATIONS.md
• 想读实现：看packages/hoppscotch-common/src/modules/i18n.ts，三层兜底逻辑全在这个文件里

常用语言代码速查

完整 35 种语言的代码、ISO 标准和 RTL 标记，以仓库里的languages.json为准。

【免费下载链接】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