# Bruno 把 API 集合放进 Git，而不是云端

> 客户禁止数据外发时，无账号、无云同步的 API 客户端能省掉安全团队的大量追问。

原文: https://fdetimes.net/zh/tools/bruno-api-collections-in-git/

在很多客户公司，安全团队对任何新工具提出的第一个问题都是：数据会去哪里？对 Bruno 来说，答案比通常短得多。Bruno 官网直接写明：没有云同步，没有账号，无需登录。

对前线部署工程师（FDE）而言，这一点比任何功能都重要。不需要开通账号，也没有厂商服务器保存集合，需要向安全团队解释的事项自然也少了。

和客户工程师一起做集成时，你逐步积累的 API 请求，会成为两个系统如何通信的记录。这份记录应该放在双方团队都能看到的地方。

## 集合是文件，而不是云端工作区

官方文档把 Bruno 描述为对 Git 友好、离线优先的 API 客户端。根据 GitHub 上的 README，Bruno 直接把集合存放在磁盘上的文件夹中，每个请求都用 Bru 这种纯文本标记语言编写。

既然是纯文本，这个文件夹就可以放在代码仓库里。Bruno 文档提到，可读的格式让开发者一眼就能看出集合改了什么。README 还说明，可以使用 Git 或其他任何版本控制系统。

这正是它与把集合存放在厂商服务器上的工具的核心区别。Bruno 自己的对比页面（也就是厂商视角）把 Postman 需要登录的云端存储模式，与 Bruno 的本地桌面应用模式放在一起对照：在后者中，根本不存在账号这个概念。

一位开发者在 DEV Community 上写道，他们在用 Git 管理一个庞大的 Postman 集合文件屡屡受挫后，转向了 Bruno。

## 示例：为集成项目新增一个接口

假设你正在把自己的系统接入客户的订单 API。项目仓库里有一个集成代码文件夹，旁边是一个 Bruno 集合文件夹，里面放着几个请求：获取 token、查询订单列表、创建测试订单。每个请求都是一个独立的 Bru 文件。

客户刚刚给订单列表接口加了一个状态过滤参数。你新建分支，在 Bruno 中修改请求并保存。Git 记录下的是一个文本文件里的一处小改动，正如 Bruno 官网所说：对 API 集合建分支、看 diff、评审、合并。

你发起 pull request。客户工程师阅读 diff，看到只新增了一行参数，对照自己的文档核实后批准。他们拉取 main 之后，新请求已经出现在自己电脑上的 Bruno 里。没有人需要用邮件发送导出文件，也不用邀请谁加入工作区。

真正的价值在于，API 变更和代码变更走同一个 pull request。评审者两者都能看到，三周后有人问起“这个请求是谁改的、为什么改”，Git 历史就能回答。

## 密钥最容易出问题

集合放进 Git，集合里的一切也都可能进入 Git。Bruno 文档说得很明确：无论通过版本控制分享还是通过导出分享，都必须先从集合中移除密钥。密钥保存在本机。

最干净的做法是把值和请求彻底分开：仓库里的请求文件只保存 token 或 API key 的变量名，真实的值留在每个人自己的电脑上。

如果确实需要把这些值存进文件，按 Git 的惯例，把文件放在仓库之外，或者写进 `.gitignore`。在第一次提交前就和客户团队约定好，每个人在自己的电脑上配置凭据。

还有一个具体习惯：每次推送前，对集合文件夹运行 `git diff --staged`，查找 `Bearer`、`token` 或 `api_key` 之类的字符串。如果看到的是真实值而不是变量名，提交前先删掉。这只需要几秒钟；而要从 Git 历史中清除一个 token，花的时间要多得多。

**要点:** 只有密钥从不随集合一起流转，把 API 集合放进 Git 才是安全的。

## 什么情况下不该选 Bruno？

项目的 README 明确表示，Bruno 只支持离线使用，永远不会有云同步。如果客户团队习惯了即时更新、无需懂 Git 的共享工作区，他们就得改变习惯。很少接触代码仓库的运维团队需要时间适应，这一点要提前排进计划。

README 还提到，大部分功能免费且开源，付费的商业版提供更多功能。在向客户承诺之前，先确认你需要的功能属于哪个版本。

## 先学什么，简历上怎么写

首先要学的不是 Bruno 的界面，而是围绕它的 Git 规范：集合文件夹放在仓库的哪个位置，API 变更的评审约定，以及如何让密钥远离提交的文件。如果你已经习惯通过 pull request 协作，这套流程大部分都会很熟悉。

写简历或回答 FDE 面试题时，不要只写“用过 Bruno”。要说明你把 API 集合放进了与客户团队共享的仓库，通过 pull request 评审变更，并让密钥远离 Git 历史。招聘方能从中同时看到集成能力和安全意识。

一个不向外发送任何数据的工具，需要回答客户安全团队的问题就更少。Bruno 押注的正是这一点，其余的则取决于你能把仓库维护得多干净。

**本周动手试试:**

- 在你正在做的集成仓库里新建一个 Bruno 集合文件夹，然后提交你最常调用的 3 个请求。
- 发起一个只修改一个请求的 pull request，比如只改一个参数，然后阅读 diff，想一想项目之外的人能否看懂这次改动。
- 下次推送前运行 git diff --staged，在集合文件夹中查找 'Bearer'、'token' 或 'api_key' 之类的字符串。

## 信源

- [What is Bruno? – Bruno Docs](https://docs.usebruno.com/introduction/what-is-bruno)

- [Bruno (usebruno.com)](https://www.usebruno.com/)

- [usebruno/bruno README (GitHub)](https://github.com/usebruno/bruno/blob/main/readme.md)

- [Bru Lang Overview – Bruno Docs](https://docs.usebruno.com/bru-lang/overview)

- [Secrets Management Overview – Bruno Docs](https://docs.usebruno.com/secrets-management/overview)

- [Bruno Vs Postman](https://www.usebruno.com/compare/bruno-vs-postman)

- [From Postman to Bruno](https://dev.to/luidynaves/from-postman-to-bruno-242f)
