环境与服务

在发送 API 请求时，经常需要在开发、测试和生产环境之间切换。Apifox 提供了便捷的环境切换功能——只需在界面右上角选择目标环境即可。

Apifox 环境由两个核心要素构成：第一个是“服务（前置 URL）”，用于维护请求的目标地址；第二个是由一组或多组“变量”组成，这些变量可以在接口或脚本中引用。切换环境时，服务（前置 URL）和环境变量都会根据当前环境中定义的值进行更新。

创建环境

点击界面右上角的 “环境管理” 按钮 ≡。

点击左侧列表最后一项 新建环境。

输入新环境的名称，添加服务前置 URL 和变量。

点击 保存。

要使用新环境，从界面右上角的环境管理中选择它。这样就把它设为当前环境，并将所有变量设置为环境中指定的值。

Apifox 的 “环境” 概念与 Postman 略有不同。Postman 通常为每个前置 URL 创建一个单独的环境，这样容易模糊环境和前置 URL 之间的界限。

相比之下，Apifox 的环境更直接地反映了开发、测试和生产等实际工作环境，而不是将每个前置 URL 视为一个独立的环境。

例如，在测试环境中，可能同时包含多个服务，如用户服务和订单服务，这些服务应当共享同一个环境，而不应分成独立的 “用户环境” 和 “订单环境”。

服务（前置 URL）

服务（前置 URL）是 Apifox 环境中的核心功能。在 Apifox 中，接口路径以斜杠（/）开头，但不包含前置 URL；在发送接口请求时，需要指定目标前置 URL。这使得环境中的服务功能变得尤为重要——选择正确的环境是发送请求的前提。

标准的前置 URL 格式以协议开头，不带尾部斜杠（/），例如：

https://127.0.0.1

或

http://abc.com/v1

每个环境都包含一个默认服务；当接口没有指定具体服务时，请求会被发送到默认服务。

例如，如果生产环境的默认服务前置 URL 是 http://abc.com/v1，而你的接口路径是 /pet，那么在生产环境发送请求时，实际发送的请求地址是：

http://abc.com/v1/pet

如果接口路径以 http:// 或 https:// 开头，前置 URL 就不会被添加到请求中。不过，一般不推荐这种做法。

BASE_URL 变量

Apifox 中有一个特殊的环境变量 BASE_URL，用于存储当前环境的“默认服务”前置 URL。通常不建议直接使用这个变量。

对于自定义脚本，建议使用 pm.request.getBaseUrl() 来获取当前接口的前置 URL，避免使用 pm.environment.get('BASE_URL')。因为如果接口没有使用“默认服务”，则可能无法正确获取当前接口的前置 URL。

如果用户手动创建了名为 BASE_URL 的环境变量，它将覆盖系统预定义的 BASE_URL。

需要注意的是，脚本无法直接修改前置 URL。在脚本中执行 pm.environment.set('BASE_URL', 'My_url') 会创建一个名为 BASE_URL 的环境变量，而不会改变前置 URL 本身。

使用多服务

如果你的项目涉及多个不同的服务，例如，用户相关的请求指向 https://user.abc.com，订单相关的请求指向 https://order.abc.com，那么你可能需要使用多服务配置。具体操作如下：

在环境中添加多个服务及其对应的前置 URL。

将接口分配到指定的服务。在文档模式下，从修改接口标签页的 “服务（前置 URL）” 下拉框中选择服务。

在调试模式下，从接口说明标签页的 “服务（前置 URL）” 下拉框中选择服务。

也可以在目录层级添加服务。点击目录名称，在目录设置中，从 “服务（前置 URL）” 下拉框选择服务。这样目录下的所有接口都会指向这个服务。

在界面右上角选择环境并点击发送，绑定到服务的接口就会被发送到对应的前置 URL。

当你在环境管理中切换到不同环境时，可能会发现用户服务和订单服务也被添加到其他环境中，但前置 URL 为空。

这是因为在大多数团队中，测试和开发环境都有对应的服务。通过为每个环境设置相应的前置 URL，当你在右上角切换环境时，所有接口请求都会被发送到正确的服务。在实践中，这是最高效的设计方式。

添加环境变量

向环境添加变量时，可以为变量指定远程值（共享）和本地值（仅保存在电脑本地）。

了解更多使用变量的信息。

切换环境

Apifox 在工作台右上角的环境管理中显示当前环境。每当你发送请求或执行脚本时，Apifox 都会使用所选环境中变量的当前值。

要切换到不同的环境，只需从环境管理中选择即可。

环境迁移

在 Apifox 中，变量的远程值会在团队内同步，而本地值仅存储在本地。这意味着，当你在另一台电脑上使用 Apifox 时，无法访问之前设置的本地值。

为了解决这个问题，Apifox 提供了环境迁移功能。你可以将环境中的服务和变量导出为 JSON 文件，并在另一台电脑上导入。操作步骤如下：

在环境管理中，将鼠标悬停在环境列表旁的 ... 上，点击 “导出” 以获取 JSON 文件。

在另一台电脑上，打开环境管理，将鼠标悬停在环境列表旁的 ... 上，点击 “导入”，并选择要导入的 JSON 文件。

你也可以导入从 Postman 导出的环境。

环境可见范围

有时，你可能需要创建仅供个人使用的变量，不希望对他人可见。这时，你可以创建一个私有环境。

在环境的右上角，你可以设置环境的可见范围。默认是共享的，而你可以将自己创建的环境设为仅自己可见。但是，你无法更改他人创建的环境的可见性。

私有环境与其他环境共用相同的服务列表。在私有环境中添加或删除服务会同时影响所有环境。

创建环境#

服务（前置 URL）#

使用多服务#

添加环境变量#

切换环境#

环境迁移#

环境可见范围#

创建环境

服务（前置 URL）

使用多服务

添加环境变量

切换环境

环境迁移

环境可见范围