PhpStorm HTTP Client 仅识别项目内 .http 或 .rest 后缀纯文本文件；首行须为大写方法+空格+完整URL；请求头顶格写；Header与Body间需空行；JSON Body须合法；发JSON需显式设Content-Type；Token、Cookie、环境变量需手动配置。
PhpStorm 内置 HTTP Client 能直接发请求、看响应，但不按它认的格式写，连发送按钮都不会亮——不是功能坏了，是文件没被识别。
怎么写 .http 文件才能被 PhpStorm 正确识别
它只认 .http 或 .rest 后缀的纯文本文件，且必须放在项目目录内（桌面或临时文件夹里无效）。首行必须是大写方法 + 空格 + 完整 URL，比如 GET https://httpbin.org/get，不能写成 get 或 Get，也不能在 URL 后加空格或注释。
- 请求头要顶格写，
Content-Type: application/json前后不能有缩进或空格 - Header 和 Body 之间必须有一行**空行**，否则 Body 被当成 Header 处理
- JSON Body 必须合法：
{ "key": "value" }可以，{ key: "value" }（缺引号）会报Unexpected token - 别把
.php文件重命名为.http—— 内容结构不匹配，PhpStorm 直接静默忽略
POST 请求发不出去？先检查这三处
90% 的 “点了没反应” 或返回 400 Bad Request 都卡在这儿：Body 格式、编码、Header 不匹配。它不会自动补 Content-Length，也不会根据 Body 类型推断 Content-Type。
- 发 JSON：必须显式加
Content-Type: application/json头，Body 顶格写，无空行 - 发表单（
application/x-www-form-urlencoded）：Header 设对，Body 写成username=%E5%BC%A0%E4%B8%89&password=123，值要 URL 编码 - URL 中含中文或特殊字符（如空格、
/、?）：必须手动 UTF-8 编码，https://api.com/用户得写成https://api.com/%E7%94%A8%E6%88%B7
怎么带 Token、Cookie 和环境变量
不传鉴权信息，401 或跳登录页是常态。HTTP Client 不读浏览器 Cookie，Token 也不自动注入，全得自己填。
立即学习“PHP免费学习笔记（深入）”；
- Bearer Token：
Authorization: Bearer {{token}}，注意Bearer后有空格；变量@token = xxx要定义在文件顶部###块里 - Cookie：
Cookie: "sessionid=abc123; path=/;"，值含等号或分号时建议用双引号包住，避免截断 - 环境变量：在项目根建
env.json，内容如{"dev": {"api_base_url": "http://localhost:8000"}}；引用写成{{api_base_url}}/users，变量名禁用点号和短横线（api.base_url会解析失败）
响应太大卡死或中文乱码怎么办
默认会把整个响应体加载进内存并尝试渲染，二进制流（如 Excel）、超长日志、未声明编码的中文响应都容易出问题。
- 大响应：加
Accept: text/plain头，或在请求末尾加###分隔，再写一个新请求做对比 - 中文显示为
你好：服务端返回的是 UTF-8，但响应头没设Content-Type: text/plain; charset=utf-8，可手动加该头再试 - 二进制内容（如 PDF、ZIP）：HTTP Client 不支持预览，只能右键 →
Save Response As...保存后用外部工具打开
最容易被忽略的是 URL 末尾的不可见字符（比如全角空格）、变量未定义就引用、以及 POST 时漏掉空行分隔 header 和 body —— 这些地方一错，请求根本不会发出，而不是发出去再失败。
