Bruno – 快速、Git 友好的开源 API 客户端

引言

在 API 开发和测试领域，开发者们一直在寻找能够提高效率、保障数据安全并易于协作的工具。Bruno 正是这样一款应运而生的开源 API 客户端，它以其快速、Git 友好和本地优先的设计理念，为开发者提供了一种与众不同的 API 交互体验。与许多依赖云同步的工具不同，Bruno 将您的 API 集合直接存储在本地文件系统中，让您完全掌控自己的数据，并通过 Git 实现无缝的版本控制和团队协作。

为什么选择 Bruno？核心理念与优势

Bruno 的设计哲学围绕着几个关键原则，使其成为许多开发者，特别是注重隐私、控制和版本管理的用户的理想选择：

• 本地优先，数据自主可控： 这是 Bruno 最核心的特性。所有 API 集合、环境变量和测试脚本都以纯文本文件的形式存储在您的本地文件系统上。这意味着：
  • 数据隐私： 您的敏感数据（如 API 密钥、请求详情）永远不会离开您的机器，无需担心云端存储的安全风险。
  • 完全控制： 您对自己的数据拥有绝对的控制权。
  • 离线工作： 无需互联网连接即可访问和修改您的 API 集合。
  • 无云同步依赖： 摆脱对特定云服务的依赖和潜在的服务中断风险。
• Git 原生集成： Bruno 将 API 集合存储为易于阅读和理解的纯文本文件（使用名为 Bru 的标记语言）。这使得利用 Git 进行版本控制变得极其自然和高效：
  • 版本追踪： 轻松追踪 API 定义的每一次变更。
  • 分支管理： 为不同环境（开发、测试、生产）或功能创建独立的分支。
  • 团队协作： 使用标准的 Git 工作流（Pull Request、Merge）进行团队协作，解决冲突也更加直观。
• 开源且免费： Bruno 在 MIT 许可下完全开源，您可以免费使用其所有功能，无需担心订阅费用或许可限制。这降低了个人开发者和小型团队的使用门槛。社区也可以自由地审查代码、贡献功能和修复 Bug。
• 简洁直观，专注于核心功能： 许多用户称赞 Bruno 的界面简洁、无干扰，专注于 API 测试的核心需求，避免了某些工具可能带来的臃肿感。启动速度和响应通常也较快。
• 规避供应商锁定： 由于数据存储在本地且格式开放，您可以随时切换到其他工具，无需担心数据迁移的困难。

主要特性详解

除了核心的设计理念，Bruno 还提供了一系列强大的功能：

• Bru 标记语言： 一种简单、直观的纯文本标记语言，用于定义 API 请求。它易于人类阅读和编写，同时也非常适合机器解析和版本控制。
  “`bru
  meta {
  name: Get Users
  type: http
  seq: 1
  }

  get {
  url: {{baseUrl}}/users
  body: none
  auth: none
  }

  vars:pre-request {
  baseUrl: https://api.example.com
  }

  assert {
  res.status: eq 200
  }
  “`
  * 声明式脚本与测试： 支持使用 JavaScript 编写请求前（Pre-request）和请求后（Post-request）脚本，用于设置变量、处理认证逻辑或编写断言来验证 API 响应。
  * 多环境管理： 轻松定义和切换不同的环境变量（如开发、测试、生产），管理不同环境下的 API 端点、认证凭据和其他变量。环境变量同样以本地文件形式存储。
  * 支持 REST 与 GraphQL： Bruno 不仅支持传统的 REST API，也内置了对 GraphQL 的支持，允许您发送查询、操作和订阅。不过，一些用户反馈其 GraphQL 功能相较于专用工具可能还有待完善。
  * 命令行界面 (CLI)： 提供了一个 CLI 工具，允许您在终端中运行 API 集合，方便集成到 CI/CD 流程或进行自动化测试。
  * 数据导入： 支持从 Postman 和 Insomnia 等流行工具导入集合，方便用户迁移。
  * 内置代码编辑器： 提供了一个功能丰富的代码编辑器，支持语法高亮、自动补全等，提升编写请求和脚本的体验。

安装与快速入门

安装 Bruno 非常简单：

• 直接下载： 访问 Bruno 官方网站 (https://www.usebruno.com/) 下载适用于您操作系统（Windows, macOS, Linux）的安装包。
• 包管理器： 也可以通过常见的包管理器进行安装，例如：
  • macOS (Homebrew): brew install bruno
  • Linux (Snap): snap install bruno
  • Linux (APT): 可通过官网提供的 .deb 包安装。

安装完成后，您可以参考官方文档的快速入门指南 (https://docs.usebruno.com/getting-started/first-request.html) 来创建您的第一个 API 请求和集合。

典型使用场景

Bruno 特别适用于以下场景：

• 个人 API 开发与测试： 简洁的界面和快速响应使其成为日常 API 调试的理想工具。
• 注重隐私和安全的团队： 本地存储特性确保敏感数据安全可控。
• 需要对 API 定义进行版本控制的团队： Git 友好性使得 API 变更管理规范化。
• 离线或网络受限环境： 无需云同步，随时随地可用。
• 开源爱好者和希望避免订阅费用的用户： 免费开源提供了极大的灵活性和成本效益。
• 将 API 测试集成到 CI/CD 流程： 通过 CLI 实现自动化测试。

用户评价与社区反馈

社区对 Bruno 的反响总体积极，但也存在一些讨论和建议：

• 正面评价： 用户普遍赞赏其简洁性、易用性、本地优先的设计以及优秀的 Git 集成。许多人认为它是 Postman 等工具的一个轻量级且更注重隐私的替代品。开源和免费也是重要的加分项。
• 改进建议与讨论：
  • 功能成熟度： 部分用户指出，相较于 Postman 等成熟工具，Bruno 可能缺少一些高级功能，例如更复杂的脚本编写能力、内置的 Mock Server 或更广泛的认证机制支持。
  • GraphQL 支持： 虽然支持 GraphQL，但有用户反馈其功能（如自动完成、模式内省）不如专门的 GraphQL 工具完善。
  • 团队协作： Bruno 的协作主要依赖 Git。一些用户希望能有更直接的内置实时协作或团队管理功能（尽管这可能与其本地优先理念相悖）。
  • UI/UX 小问题： 少数用户报告了界面上的一些小瑕疵或性能问题。
  • 文档与社区资源： 虽然在不断改进，但部分用户希望看到更丰富的教程、示例和更活跃的社区论坛。

与同类工具对比 (Postman, Insomnia)

选择哪个工具取决于您的具体需求和偏好。如果您重视数据隐私、喜欢 Git 工作流并且需要一个简洁免费的工具，Bruno 是一个非常有吸引力的选择。如果您需要最全面的功能、强大的云协作和成熟的生态系统，Postman 可能更合适。Insomnia 则在两者之间提供了一个平衡。

注意事项与局限性

在使用 Bruno 时，需要注意以下几点：

• 高级功能缺失： 对于需要极其复杂脚本、Mocking、高级自动化测试或特定认证流程的用户，可能需要评估 Bruno 当前的功能是否满足需求。
• 团队协作依赖 Git： 团队需要熟悉并依赖 Git 进行协作，它不提供像 Postman 那样的实时同步或内置用户管理。
• 插件生态系统： 相较于 Postman 或 VS Code，Bruno 的插件生态系统尚在发展初期。
• GraphQL 功能： 如果您的主要工作是处理复杂的 GraphQL API，建议同时评估专门的 GraphQL 客户端。

总结

Bruno 是 API 客户端领域一个令人耳目一新的选择。它坚定地走本地优先、Git 友好和开源的道路，解决了许多开发者对数据隐私、版本控制和工具简洁性的核心诉求。虽然在功能丰富度和生态成熟度上可能不及某些老牌商业工具，但其独特的设计理念和活跃的开发进程使其成为一个值得关注和尝试的强大工具。

如果您正在寻找一个能够让您完全掌控数据、无缝集成版本控制且免费使用的 API 客户端，那么 Bruno 绝对值得一试。

相关链接:

• 官方网站: https://www.usebruno.com/
• GitHub 仓库: https://github.com/usebruno/bruno
• 官方文档: https://docs.usebruno.com/

欢迎试用 Bruno，并通过 GitHub Issues 或社区渠道分享您的反馈，参与到这个优秀的开源项目中来！