上手Bruno API测试：搜索中文关键词与用Git管理集合
【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno
团队的API集合涨到几百个请求后，中文命名的请求最直观，也最容易在文件夹里点得眼花。Bruno是一个开源的API测试工具，把集合以纯文本文件存在本地文件系统里，不用账号、不依赖云端。这里直接讲三件事：用全局搜索定位中文关键词、用Git管理集合、用CLI批量跑集合。
图：Bruno的主界面，左侧集合树与右侧请求编辑区，请求名称、参数均可使用中文
Bruno的纯文本存储为什么适合中文团队
用.bru文件写中文请求名
Bruno把每个请求存成一个.bru文件，内容是纯文本。请求名、头部描述、环境变量的值、脚本里的注释，都可以直接写中文，用任何文本编辑器都能打开核对。相比存数据库的方案，编码问题一眼就能看出来，也方便人工检查。
让全局搜索命中中文关键词
Bruno的全局搜索框会同时匹配集合名、请求名、请求URL和文件夹路径。输入内容按空格拆分成多个词，全部命中才算匹配，所以输入“用户 认证”会筛出名称里同时包含两个词的请求，比单关键词的结果更精准。
用Git给集合做版本控制
集合本质就是一个普通文件夹，对它执行git init就能纳入版本控制。每次改动提交一次，diff里能看到具体是哪个请求、改了哪几行，回滚也只需一条git命令。
图：Bruno的集合作为本地文件夹可直接用Git管理，每个.bru文件的变更都有记录
实操走查：5步从零到团队协作
- 选一个本地目录，在Bruno里新建集合，然后在该目录执行
git init并提交一次。预期：集合从第一天起就有版本记录。 - 在集合里新建
.bru请求，命名为“获取用户信息”，URL、参数说明、断言都用中文写。预期：界面正常显示中文，无乱码。 - 打开全局搜索框，输入“用户 认证”。预期：目标请求直接命中，点开即编辑。
- 修改请求后
git add并提交，同事拉取最新提交。预期：两边请求配置一致，历史可追溯。 - 安装Bruno CLI后，在集合目录执行
bru run。预期：整个集合批量执行并输出结果报告。
图：Bruno CLI在终端中运行集合，适合本地和CI场景
进阶技巧
技巧1：多词AND缩小范围 搜索按空格拆词且要求全部命中，搜不到时删掉一个词放宽条件；反过来，词越多结果越精确。URL里含关键词的请求同样会命中，不只限于名称。
技巧2：单文件调试，整集回归bru run 某个请求.bru只执行这一个文件，修单个请求时很顺手；通过后整集再跑一次，确认没有连带影响。
技巧3：环境变量也用中文命名 环境变量的名称和值都可以用中文，比如“基础地址”，在URL里引用即可。环境切换时改的是一组中文变量，比记变量拼音不容易出错。
踩坑速查
搜索中文关键词没有结果 原因：搜索只匹配请求、集合、文件夹名称和URL，不匹配文件正文内容。 解法：把关键词写进请求名或URL，别指望正文能被搜到。
clone后中文显示乱码 原因：终端或编辑器编码不是UTF-8，.bru文件解码出错。 解法：把终端和编辑器统一设为UTF-8后重新拉取。
菜单里找不到中文选项 原因：Bruno界面语言包目前只提供英文，请求内容不受影响。 解法：熟悉少量英文菜单，请求名、参数、脚本里的中文照常使用。
收束
Bruno对中文团队的价值在于三点：搜索能命中中文名称、Git能追溯每次改动、CLI能批量执行集合，全都建立在纯文本文件这个底座上。
- 查官方文档补齐.bru文件格式与CLI完整命令
- 到社区讨论区看多人协作时的高频问题
- 想进CI流水线，看CLI与Docker镜像的运行示例
把第一个中文命名的请求跑通，后面的事就顺了。
【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
