PhpStorm内置HTTP Client发不出请求，根本原因是文件未被识别：后缀非.http或.rest、首行非“大写方法+空格+完整URL”、文件不在项目目录内、含BOM或不可见字符——缺一即静默失败。
接口在 PhpStorm 内置 HTTP Client 里发不出去，不是网络问题，而是文件没被识别或格式错得连请求都构造不出来——GET 小写、URL 后带空格、变量未定义、缺 XDEBUG_SESSION_START 头，任意一个都会让请求静默失败。
为什么光标停在 GET 行却没绿色甲虫图标
PhpStorm 根本没把这行当请求处理，说明文件未被识别为 HTTP 请求文件。
- 文件后缀不是
.http或.rest（比如误存为.txt或直接改名.php.http） - 首行不是严格“大写方法 + 单个空格 + 完整 URL”，例如：
get https://api.com（小写）、GET https://api.com # 注释（URL 后有字符）、GET https://api.com/用户（中文未编码） - 文件不在 PhpStorm 打开的项目目录内（放在桌面、Downloads 或系统临时路径下，一律不扫描）
- 首行前面有 BOM 或不可见 Unicode 字符（常见于从网页复制 URL 时带入）
发出去了但返回 400 或完全没响应
请求发出了，但服务端拒绝或客户端解析失败，本质是结构不合规。
-
POST请求体前必须有且仅有一个空行；少这个空行，Content-Type会被当成 URL 参数的一部分 -
Content-Type: application/json必须顶格写，不能有前导空格，也不能写成content-type（大小写敏感） - JSON body 必须顶格、无缩进、双引号完整：
{"name":"Alice"}✅，{name:"Alice"}❌（key 缺引号），{\n "name": "Alice"\n}❌（含换行+缩进） - URL 中含中文、空格、
#等字符，必须手动encodeURIComponent()编码，不能裸写?q=你好
断点不命中，XDEBUG_SESSION_START 加了也没用
加了头只是“喊了一嗓子”，不代表 Xdebug 真连上了。
立即学习“PHP免费学习笔记（深入）”；
-
XDEBUG_SESSION_START: PHPSTORM必须显式出现在请求头里（不能只靠 cookie 或 GET 参数） - PHP CLI 和 Web SAPI（如 Apache/Nginx 的 PHP）必须加载同一套 Xdebug 配置，且
xdebug.mode=debug已启用 -
xdebug.client_host必须设为宿主机 IP（Docker 场景下常错设为localhost，实际应填宿主机局域网 IP） - 请求 URL 必须能被当前 Web 服务器路由到对应 PHP 脚本——若用框架（Laravel/Slim），断点要打在入口文件（如
public/index.php），而非路由映射的控制器文件
变量报 Cannot resolve variable 怎么快速定位
变量名写错、位置放错、值为空，三者任一都会导致引用失效，且 PhpStorm 不提示具体哪一行错。
- 变量名只允许字母、数字、下划线：
@api_host✅，@api.host❌，@auth-token❌ - 必须先定义、后引用：全局变量写在文件最顶部；块级变量（
### @env dev下）只对之后的请求生效 - 若用
http-client.env.json，必须放在项目根目录，且字段名与{{xxx}}完全一致（"base_url": ""→ 引用{{base_url}}，不能写{{baseUrl}}） - 变量值为空时，PhpStorm 不报错也不发请求，只显示
Variable 'xxx' is not defined——检查所有@xxx =右侧是否真有值
最容易被忽略的是：变量作用域靠定义位置决定，而不是靠你“觉得它该在哪生效”；POST 请求体里多一个空格、少一个引号，就足以让服务端拒收，而 PhpStorm 不校验 JSON 合法性，只按字面转发。
