Hoppscotch 多语言界面完整指南:3 步切换到 34 种语言,团队各看各的母语【免费下载链接】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海外同事加入 API 测试时,满屏英文界面常是第一道门槛。Hoppscotch 的多语言支持可以把界面一键切成 34 种语言,每位成员都能用自己熟悉的母语操作同一个项目。功能速览Hoppscotch 的界面文本全部走国际化机制:每种语言一个 JSON 文件,按功能模块(如action、auth、settings)组织键值对。它解决两类问题:场景说明界面本地化34 种语言任选,含简繁中文、日语、阿拉伯语(自动从右向左排版)等多语言 API 测试配合请求头和请求头配合环境变量,模拟不同语言用户的真实请求切换动作即时生效,且每个浏览器各自记住你的选择。快速上手:三分钟完成语言切换打开 Hoppscotch,点击顶部导航栏右侧的头像按钮,在下拉菜单中选中设置。在设置页「常规」区域找到语言一项,点击当前语言按钮(如English)。弹出列表顶部带搜索框,直接输入语言名,例如简体或日本語,点击匹配项即可。验证:界面按钮、菜单立即变为所选语言;刷新页面仍是该语言——设置已写入浏览器本地存储,不会丢。整个过程无需改任何文件,无需重启。进阶配置:按场景调语言不手动切换也能猜对语言首次打开(本地没有任何记录)时,Hoppscotch 会读取浏览器语言自动匹配:浏览器是zh-CN就进简体中文界面,ja-JP就进日语界面;匹配不到才退回英文。所以新设备第一次打开先别急着手动切,看看是否已经猜对了。语言偏好存在哪当前语言存在浏览器 localStorage 里,按浏览器、按设备隔离。含义:Chrome 切了中文,Firefox 里还是英文;公司电脑和个人电脑互不同步。清除网站数据后,下次会重新走「浏览器语言猜测」逻辑。从源码构建时新增一个语言包以越南语为例(仓库已内置的语言可跳过此节):复制 语言包目录 下的en.json为vi.json,逐条翻译;在 languages.json 中追加一条注册信息,字段参考现有条目:{ code: vi, file: vi.json, iso: vi-VI, name: Tiếng Việt }重新构建项目。注意:code决定存储和匹配逻辑(如cn对应zh-CN),name是下拉菜单里显示的名字;从右向左书写的语言(如阿拉伯语)需额外加dir: rtl。实战演练:跨时区团队 多语言接口验收假设你们在做一个面向日本和巴西市场的站点,需要验收Accept-Language分支。按下面步骤把界面语言和能力串起来:日本的前端把界面切到日本語,巴西的测试切到Português Brasileiro,各自用母语界面操作同一工作区,互不干扰——界面语言只影响「看的」,不影响「发的」。新建环境accept-language-test,加一个变量lang,值先填ja-JP。打开任意请求的 Headers 标签,新增一行:键Accept-Language,值{{lang}}。把环境切换到accept-language-test发送请求,确认响应符合日语分支预期。回到环境面板,把lang改成pt-BR再发一次,对比两份响应;响应查看器可正常显示日文、葡萄牙文等特殊文字,也可搜索、复制。排错清单切到中文后部分菜单还是英文→ 该语言包缺对应翻译键,系统自动回退英文。检查locales/cn.json里有没有这个键,没有就按 翻译指南 补上。换个浏览器/设备,语言变回英文→ 偏好存在各浏览器本地,且首访按浏览器语言猜测。到新环境手动切换一次即可,属正常行为。手改语言文件后整个界面变英文→ JSON 语法错误(缺逗号、引号不闭合)导致该语言包加载失败,整体回退英文。用 JSON 校验工具检查,并确保文件以 UTF-8 保存。新加的语言在下拉列表里不出现→ 只建了 JSON 文件但没在languages.json注册,或构建时没把新文件打包进来。两步都补齐后重新构建。旧版本链接形如/es/...打不开或跳转奇怪→ 旧版用 URL 前缀表示语言,现在会兼容改写:按链接里的语言码切换界面后去掉前缀,属内置兼容逻辑,无需处理。收尾Hoppscotch 的多语言把「界面语言」和「请求语言」分成两层:前者 3 步搞定、按浏览器记忆,后者靠Accept-Language加环境变量灵活模拟。发现翻译用词不准时,直接改对应 JSON 里的键值并提交 PR,流程见 TRANSLATIONS.md;疑问可走项目 Issue 或官方 Discord 社区反馈。附录:语言代码与路径速查代码语言对应文件cn简体中文(zh-CN)locales/cn.jsontw繁體中文(zh-TW)locales/tw.jsonenEnglishlocales/en.jsonja日本語locales/ja.jsonko한국어locales/ko.jsonfr/de/es法 / 德 / 西locales/{fr,de,es}.jsonpt-brPortuguês Brasileirolocales/pt-br.jsonarالعربية(RTL 排版)locales/ar.json内容路径语言包目录(34 个语言文件)packages/hoppscotch-common/locales语言注册清单languages.json翻译贡献流程TRANSLATIONS.md国际化模块源码src/modules/i18n.ts设置页(语言入口)src/pages/settings.vue【免费下载链接】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），仅供参考