IntelliJ IDEA 怎么用 HTTP 文件调试接口和切换环境

IntelliJ IDEA 自带的 HTTP Client 适合把接口调试请求和项目代码放在一起管理。最实用的做法是：先创建一个物理 .http 文件，再用 http-client.env.json 保存开发、生产两套地址，最后在请求编辑器顶部的 Run with 中切换环境。这样请求路径只写一份，执行后还能在 Services 工具窗口直接核对状态码和 JSON 响应。

步骤一：创建物理 HTTP 请求文件

打开一个已经加载的 IntelliJ IDEA 项目，在左侧 Project 面板选中准备存放接口调试文件的目录。依次点击 File > New > HTTP Request，把文件命名为 requests.http。物理文件和 Scratch File 的区别是：它会留在项目里，适合团队重复使用，IDE 也不会因为执行请求而改写原文件。

先写一条最小请求。示例中的地址只是占位地址，换成你自己的测试服务即可：

### 查询订单
# 使用环境变量，避免把主机写死在请求里
GET http://{{host}}/api/orders/42
Accept: application/json

看到请求左侧出现运行图标，说明 HTTP Client 已经识别出方法和 URL。这里的 ### 是请求分隔符，后面的中文名称只用于在 Structure 或运行配置中定位，不会发送给服务端。

步骤二：配置开发和生产环境

把光标放在请求编辑器里，看顶部的 Run with 下拉菜单。选择 Add Environment to Public File…，IDE 会在项目中创建 http-client.env.json。如果菜单里没有这项，也可以手动在项目目录创建同名文件。JSON 不能写注释，所以用环境名分组表达用途：

{
  "development": {
    "host": "dev.example.test"
  },
  "production": {
    "host": "api.example.com"
  }
}

需要账号、密码或令牌时，选择 Add Environment to Private File…，写入 http-client.private.env.json。私有文件中的同名变量会覆盖公共文件，但它不会自动加入 Git 的 .gitignore；如果项目使用 Git，要手动忽略它，避免把敏感配置提交出去。

回到 requests.http，在顶部选择 development。此时请求仍显示 {{host}}，但执行时会替换成开发环境地址；切到 production 时只改变变量值，不改变请求正文。

步骤三：选择环境并发送请求

确认 Run with 显示目标环境后，点击 GET 请求左侧的运行图标。执行请求会打开 Services 工具窗口，重点看三处：响应状态码、响应头里的 Content-Type，以及 JSON 正文是否是当前接口返回的数据。

正常响应还会被保存到项目的 .idea/httpRequests/ 目录，之后可以从 Requests History 回看。若一个文件里有多条请求，可以点击编辑器顶部的 Run All Requests in File；日常排错建议先单独运行当前请求，确认环境无误后再批量执行。

步骤四：处理变量未解析和环境误用

排查时不要只盯着 URL。先确认环境选择，再确认变量是否解析，最后查看 Services 中的响应地址和状态码。这样可以把“请求没有发出去”和“请求发出但服务返回错误”分开处理。

常见问题

HTTP 文件应该用 .http 还是 .rest？

两种扩展名都用于 HTTP 请求文件，团队内选一种统一即可。本文使用 .http，因为它更容易与常见的 HTTP Client 示例对应。

切换环境后为什么 URL 看起来没有变化？

环境变量替换发生在执行时，编辑器仍显示 {{host}} 是正常的。以 Services 中实际请求和响应为准。

能不能把密码直接写进公共环境文件？

不建议。公共文件适合主机、端口等可共享配置，密码和令牌应放私有环境文件，并用 Git 忽略规则保护。

完成后可以用同一份 requests.http 先选 development 做联调，再选 production 做受控验证；每次发送前看一眼 Run with，发送后看 Services 的状态码和正文，环境切换就有了明确的确认点。