PhpStorm HTTP Client 仅识别 .http 或 .rest 文件，首行须为完整请求行（如 GET https://api.example.com/users），后接空行和请求头，JSON 请求体需顶格无空行且配 Content-Type 头；变量用 {{var}} 引用，定义于项目根 env.json 中，命名禁用点号和短横线；大响应可加 Accept: text/plain 或用 ### 分隔请求。
HTTP Client 文件怎么写才能被 PhpStorm 识别
phpstorm 内置的 http client 只认 .http 或 .rest 后缀文件，且必须在文件首行声明请求方法和 url，否则不显示“run”图标。它不是通用脚本引擎，不解析注释开头的请求，也不支持变量未定义就引用。
- 第一行必须是
GET https://api.example.com/users这类完整请求行（含方法 + 空格 + URL） - 请求头要写在空行之后，每行一个，格式为
Content-Type: application/json - 请求体如果是 JSON，建议加
Content-Type: application/json头，否则默认按text/plain发送 - 别把
.php或.js文件强行改成.http后缀——内容结构不匹配，PhpStorm 会静默忽略
如何在请求里复用环境变量和项目变量
硬编码 URL 和 Token 是调试中最容易过期、最难维护的部分。PhpStorm 支持两级变量：项目级（env.json）和运行配置级（临时覆盖），但变量名不能含点号或短横线，比如 api.base_url 会解析失败，得写成 api_base_url。
- 在项目根目录建
env.json，内容为{"dev": {"api_base_url": "http://localhost:8000"}} - 请求中用
{{api_base_url}}/users引用，PhpStorm 会自动补全并高亮 - 发送前点击右上角环境选择器，选
dev；如果没出现，检查env.json是否在项目根、JSON 格式是否合法 - 变量值为空时，请求会卡住或报
Cannot resolve variable 'xxx'，不是崩溃，而是直接拒绝执行
POST 请求发不出去？先看这三处
最常见的“点了 Run 没反应”或“返回 400”问题，90% 出在请求体格式、编码和头不匹配。PhpStorm 的 HTTP Client 不会自动帮你补 Content-Length，也不会根据 body 类型智能设 Content-Type。
- JSON 请求体必须顶格写，不能缩进，且前后不能有空行——否则会被当字符串字面量发送
- 如果用了
multipart/form-data，必须手写 boundary，推荐改用curl命令或 Postman；HTTP Client 对 multipart 支持弱，容易漏字段 - 表单提交用
x-www-form-urlencoded时，body 要写成username=john&password=123，不是 JSON 对象，也不是键值对列表 - 发完看响应面板下方的 “Request Headers” 和 “Request Body” 折叠区，确认实际发出的内容跟你写的是否一致
响应太大卡死？怎么限制或跳过解析
默认情况下，PhpStorm 会尝试将响应体完整加载进内存并语法高亮（尤其是 JSON/XML）。遇到几 MB 的日志流或二进制响应，编辑器可能假死或 OOM。它没有全局开关关语法高亮，但有实用绕过方式。
- 在请求末尾加
###分隔符，再写下一个请求——这样每个响应独立渲染，不会累积 - 对大响应，加
Accept: text/plain头，强制服务端返回纯文本，避免 JSON 解析器介入 - 想跳过响应体显示，只看状态码和头？在设置里关掉
Settings > Tools > HTTP Client > Show response in editor，改用控制台输出模式 - 注意：关闭后，
Ctrl+Click跳转 JSON 字段、自动格式化等功能全部失效，只是权衡
