IntelliJ IDEA 2023 怎么配置 HTTP Client 请求环境变量？

在 IntelliJ IDEA 2023 系列版本中，配置 HTTP Client 环境变量最标准的方法是使用 http-client.env.json 文件，配合请求文件中的 {{变量名}} 语法实现动态替换。这种方式能有效分离请求逻辑与环境参数，避免硬编码敏感信息。

先说结论：通过创建特定的 JSON 配置文件管理多环境参数，实现一键切换开发、测试、生产环境。

核心文件：http-client.env.json（注意文件名大小写）
引用语法：{{变量名}}
安全建议：将该配置文件加入 .gitignore，严禁提交真实生产密钥
验收标准：切换环境后，请求 URL 及 Header 中的变量能自动解析为对应值

配置文件编写 (http-client.env.json)

在项目根目录或 .http 请求文件同级目录下，新建名为 http-client.env.json 的文件。JSON 结构外层键为环境名（如 dev、prod），内层为具体变量键值对。

{
  "dev": {
    "host": "localhost:8080",
    "token": "dev-token-123",
    "timeout": "5000"
  },
  "prod": {
    "host": "api.example.com",
    "token": "prod-token-xyz",
    "timeout": "10000"
  }
}

注意：JSON 语法必须严格正确，多余的逗号或缺失的引号会导致所有环境变量失效。

IntelliJ IDEA 2023 怎么配置 HTTP Client 请求环境变量？

请求文件编写与变量引用 (.http)

新建 .http 或 .rest 文件，使用 {{变量名}} 格式引用上述配置。以下是一个完整的请求示例，包含 URL、Header 和 Body 的变量引用：

### 获取用户信息
GET https://{{host}}/api/v1/users
Authorization: Bearer {{token}}
Content-Type: application/json

### 创建订单 (POST 示例)
POST https://{{host}}/api/v1/orders
Content-Type: application/json

{
  "userId": "1001",
  "timeout": {{timeout}}
}

IDE 会对未定义的变量显示警告提示，确保变量名与 env 文件中完全一致。

环境切换与结果验证

1. 切换环境：在 .http 文件编辑器左上角，找到环境下拉框（通常显示当前环境名，如 dev），点击选择目标环境（如 prod）。

2. 发送请求：点击请求行左侧的绿色三角形运行按钮。

3. 验证解析：发送请求后，点击右侧响应面板中的 'Request' 标签页，查看 'Final URL' 及 Headers 是否已替换为具体值。如果变量未解析，通常会保留 {{}} 原样或提示错误。

安全警告与常见坑

安全警告：http-client.env.json 可能包含敏感信息（如 token、密码）。严禁在该文件中填入真实生产密钥，并务必在项目根目录的 .gitignore 文件中添加 http-client.env.json，防止意外提交到代码仓库。

常见排查步骤：

文件名大小写敏感，必须是 http-client.env.json，不能是 Http-Client.Env.json。
切换环境后需重新发送请求才能应用新值，IDE 不会自动刷新已发送的请求。
如果变量显示红色警告，检查变量名拼写或当前选中的环境是否包含该变量。
JSON 文件中不支持注释，如需说明请使用单独的文档。

更多细节可参考 JetBrains 官方文档：Environment variables in HTTP requests。