Bruno API 测试工具完整实操中文环境调优与搜索上手指南【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 是一款本地优先的开源 API 测试工具请求保存为纯文本文件集合目录可直接纳入 Git 管理适合需要离线工作、想把 API 配置做版本控制的开发者。本文从安装到第一个请求讲清中文环境调优、搜索技巧与 Git 接入全程约 10 分钟。一、Bruno 的定位本地优先意味着什么维度BrunoPostman数据存储位置本地纯文本 .bru 文件云端账号 本地缓存离线可用性完全离线可用核心功能依赖云同步Git 协作集合目录直接进仓库需导出/导入中转请求即文件意味着 3 件事改动可 diff、可 review断网时功能不打折集合目录就是一个可 clone 的仓库团队共享不依赖任何账号体系。二、10 分钟上手从安装到第一个请求安装与界面认识从官网下载对应系统的安装包双击安装即可无需注册账号。启动后界面分 4 个区域左侧是集合与请求的树形目录右侧是请求编辑器Params、Headers、Body 等分区底部是响应面板顶部为标签栏。创建集合、配置环境、发出第一个请求3 步发出第一个请求在左侧边栏右键选择 New Collection 新建集合或 Open Collection 打开一个已有目录在集合下新建请求填好方法与 URL可顺手在右侧环境面板创建一个 Local 环境把域名写成变量选择环境后点击发送响应面板即返回状态码与正文。三、中文环境调优界面语言Preferences → Language从菜单栏打开 Preferences 面板语言条目位于 Preferences → Language选择简体中文后界面即时切换。需要说明当前开源版本的 i18n 模块packages/bruno-app/src/i18n/随包只附带英文翻译文件如果你的版本里没有 Language 条目即代表该版本尚未启用多语言界面默认为英文后续版本会逐步补齐。乱码与字体处理.bru 请求文件是 UTF-8 编码的纯文本。若中文显示为问号或方框多半是文件被非 UTF-8 方式保存过用编辑器打开以 UTF-8 重新保存后再提交即可。界面中文模糊时在 Preferences → Display → Font 中更换一款支持中文的等宽字体如 Sarasa Mono 系列正文与变量列表都会同步生效。四、搜索提效技巧关键词组合与通配符用法用快捷键打开全局搜索面板。多个关键词用空格分隔所有词都必须同时命中才返回结果适合用户 登录这类组合定位。要提醒的是当前版本的搜索是子串匹配加路径匹配的机制尚不支持通配符与正则表达式做模糊查找时应缩短关键词而不是添加*。命中内容会在结果中高亮显示。按文件类型和目录快速定位请求在搜索框输入带前导斜杠的目录路径如/auth/结果即限定到该目录内。结果按 集合 文件夹 请求 URL 路径 的优先级排序每条都带完整路径双击直接跳转到对应请求长集合里定位不超过 2 次点击。五、团队协作Git 版本控制落地集合目录接入 Git 的步骤进入集合所在目录执行以下命令完成初始化并提交把仓库推送到团队的远端代码托管服务同事 clone 后用 Bruno 打开目录即可使用后续更新走 git pull。git init git add . git commit -m init collection.bru 文件是纯文本commit 内容天然可读代码评审时能直接看出哪个 Header 被改了。变更追溯与回滚用git log -p查看每个请求文件的修改历史需要回滚时用git checkout commit号 -- 文件名把单个请求恢复到指定版本。建议约定提交信息写请求名 变更内容例如users: 增加分页参数追溯时一眼可辨。六、进阶IDE 插件集成与自动化测试同一个集合目录可以直接用 VS Code 打开编辑.bru 文件改完后桌面端会自动同步加载适合习惯在 IDE 里工作的场景自动化测试走命令行安装 bruno-cli 后在集合目录执行下面两条命令即可跑完整集合支持--env指定环境、--reporter-json导出结果可挂进 CI 流水线。npm install -g usebruno/cli bru run七、常见问题速查现象可能原因处理方式.bru 中中文变乱码文件被非 UTF-8 方式保存用编辑器以 UTF-8 重新保存再提交中文关键词搜不到结果关键词过长或含特殊符号缩短为部分词或改用路径前缀限定目录界面中文字体发虚系统缺少中文等宽字体安装中文字体在 Preferences → Display → Font 更换集合更新同事看不到集合目录未纳入 Git 仓库按第五章步骤提交并推送目录bru 命令提示不存在CLI 未安装或未生效重新执行 npm install -g usebruno/cli上手指引清单安装 Bruno3 步发出第一个请求检查 .bru 文件均为 UTF-8 编码界面字体已换中文等宽字体用空格多关键词 /目录前缀跑一次集合内搜索集合目录 git init 并提交团队约定提交信息格式用 bru run 跑通一次自动化执行并导出 JSON 报告【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考