企业官网建设流程全解析

Bruno 中文支持现状与搜索功能实战：3 个技巧让找接口更顺手

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno

场景：找接口靠拼音缩写？

接口越攒越多之后，找东西就变难了：几百个请求全是英文名，想找一个"登录"相关的接口，只能凭记忆一层层翻文件夹。

Bruno 是一款开源的 API 探索与测试 IDE（Postman/Insomnia 的轻量替代品）。中文用户上手时最常问两件事：Bruno 中文支持到什么程度？Bruno 搜索功能到底有多好用？这篇就把这两件事讲清楚。

Bruno 是什么：一句话定位

Bruno 把集合做成"本地文件夹 + 纯文本文件"的形式，核心卖点：

• 请求存成.bru文件（Bruno 存单个 API 请求的纯文本文件）
• 打开本地目录即集合，不注册账号
• 离线可用，数据全在本地磁盘
• 内置全局搜索，跨集合找请求
• 附带 CLI，命令行里能跑整个集合

中文支持：现状、能改什么、怎么改

📌 先说现状：Bruno 的界面文案目前基本是英文。本地化框架（i18next，一个常用的前端多语言库）已经接好，但翻译资源很薄。

能改什么？改的入口是packages/bruno-app/src/i18n/index.js。它现在只注册了英文资源，lng固定为'en'。

最小改动分两步：

1. 新建中文资源文件packages/bruno-app/src/i18n/translation/zh-CN.json，先翻译高频词条：

{ "WELCOME": { "CREATE_COLLECTION": "创建集合" } }

2. 在index.js里注册这个文件，并把默认语言切过去：

import translationZhCN from './translation/zh-CN.json'; // resources 里加 'zh-CN': { translation: translationZhCN }，lng 改为 'zh-CN'

改完之后的效果：欢迎页会出现中文的"创建集合"，其余界面仍是英文。建议先把自己每天要点的菜单翻完，再逐步铺开。

搜索功能实战：从"能搜"到"搜得快"

基础搜索怎么用

🔍 Bruno 有两个搜索入口：全局搜索是弹窗式，侧边栏搜索是就地过滤。

快捷键定义在packages/bruno-app/src/providers/Hotkeys/keyMappings.js，排查快捷键问题时可以先看这个文件。

搜索技巧

1. 按方法名搜：.bru里习惯把方法写在名字前面（如get-user-list），直接输get-user就能命中。
2. 路径前缀匹配：全局搜索会对请求的 URL 做子串匹配，输/api/v1/orders会列出该前缀下的所有接口。
3. 别指望 tag：匹配范围只有名字、URL、路径，tag 不在其中；常搜的关键词请直接放进请求名里。

多词搜索是 AND 关系，每段都要匹配：

login token # 两个词必须同时命中 /api/v1/orders # 命中包含该路径前缀的 URL

搜索不到的排查清单

• ❌ 集合没打开：全局搜索只覆盖当前工作区里的集合
• ❌ 多词里有一段拼错：AND 逻辑下任一段不命中就没有结果
• ❌ 想按 tag 搜：tag 不是匹配字段
• ✅ 正确姿势：先搜/v1/这类短片段确认有结果，再逐段缩小

进阶：管理 500+ 个接口时

如果你管理的集合超过 500 个接口，决定"搜得快不快"的其实是目录结构。建议按业务域分 2~3 层：

user-service/ ├── auth/ │ ├── login.bru │ └── refresh-token.bru └── orders/ └── list-orders.bru

因为.bru是纯文本，整个集合放进 git 仓库后，接口的增删改、重命名都会留在提交历史里——这是纯文本格式天然带的优势，不用额外做什么。

常见问题

翻译文件放在哪里？

packages/bruno-app/src/i18n/translation/，目前只有en.json，新语言照同样结构加文件即可。

中文文件名能用吗？

文件夹和.bru文件用中文名基本没问题；团队跨 macOS / Windows 协作时留意 git 的跨平台编码显示即可。

搜索区分大小写吗？

不区分，搜索词和目标文本都会先转小写再比较。

快捷键能自定义吗？

可以。keyMappings.js里会把用户偏好合并进默认快捷键表，在偏好设置里覆盖对应动作即可。

下一步

• 中文 README
• 贡献指南
• 搜索快捷键的 E2E 测试示例

给 Bruno 加一个zh-CN.json是中文本地化的第一步，把 ⌘K 练成肌肉记忆是搜索提速的第一步。用上一周，你会自然形成自己的命名和目录习惯，那才是省时间的地方。

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno