PhpStorm HTTP Client 要正常运行，必须满足四个前提：文件后缀为 .http 或 .rest、置于项目目录内、首行为大写方法+空格+完整URL（如GET https://example.com）、变量先定义后引用且命名合规；缺一则绿色调试图标不亮，请求无法发送。
能直接跑，但前提是文件被识别、格式写对、变量定义到位——缺一不可，否则连绿色甲虫图标都不会亮。
为什么 .http 文件没反应，光标停在 GET 行也不发请求
根本不是功能坏了，是 PhpStorm 根本没把它当 HTTP 请求文件处理。
- 文件后缀必须是
.http或.rest，重命名.php或.txt无效 - 文件必须放在 PhpStorm 打开的项目目录内（桌面、下载、临时文件夹都不行）
- 首行必须严格为
GET https://example.com/api这种格式：大写方法 + 单个空格 + 完整 URL，不能有注释、空格、中文或编码错误 - URL 中含中文、空格、
/、?等字符时，必须手动 UTF-8 编码，比如/用户得写成/%E7%94%A8%E6%88%B7 - 首行没亮起绿色甲虫图标？别调试，先检查这四点
POST JSON 总返回 400，到底哪错了
90% 的 400 不是后端问题，而是 .http 文件结构不合规，HTTP Client 按字面解析，错一个空行就失败。
- 结构必须严格三段：请求行 → 空行 → Header → 空行 → Body（顶格、无缩进）
-
Content-Type: application/json必须显式写出，且单独成行、前后无空格、大小写敏感 - JSON Body 必须合法：
{"name":"Alice"}✅，{name:"Alice"}❌（key 缺引号）、{"name": "Alice",}❌（尾逗号） - Body 不能有 BOM、不能混入全角空格、不能换行后多空行
- 如果 Body 是表单数据，
Content-Type得换成application/x-www-form-urlencoded，且字段值要 URL 编码
变量总报 Cannot resolve variable，怎么定义才生效
变量名和作用域规则很硬，不按它来，就直接卡住不发请求。
立即学习“PHP免费学习笔记（深入）”；
- 变量名只允许字母、数字、下划线：
@api_host✅，@api.host或@auth-token❌ - 必须“先定义、后引用”：把
@api_host = http://localhost:8000写在文件最顶部，才能被下面所有请求用到 - 若用
http-client.env.json，必须放在项目根目录，内容扁平：{"dev": {"base_url": "http://localhost:8000"}}，引用写{{base_url}}，不能写{{dev.base_url}} - 变量值为空时，PhpStorm 不报错也不发请求，只显示
Variable 'xxx' is not defined - 环境切换靠右上角下拉菜单，不是改
@env值或删块
调试 PHP 接口断点不命中，XDEBUG_SESSION_START 够吗
够了，但只是启动调试的“钥匙”，不是“通道”本身。
-
XDEBUG_SESSION_START: PHPSTORM必须显式加在请求头里（不是 query 参数，不是 cookie），值要和 PhpStorm 设置里的 Debug session ID 一致 - PHP CLI 和 Web SAPI 必须都加载了 Xdebug，
php -v和phpinfo()都得看到 Xdebug 信息 -
xdebug.client_host必须指向宿主机 IP（Docker 场景常错设为localhost） - 断点打在实际被执行的文件上——框架路由下，入口通常是
public/index.php，而不是你直写的api/users.php - 路径含中文或空格时，Xdebug 3.2+ 解析不稳定，建议全英文路径
真正容易被忽略的是：变量未定义时请求静默拒绝，空行缺失时 Body 被当 Header 处理，Xdebug 配置只在 CLI 生效却去调 Web 接口——这些都不是“功能异常”，而是规则没踩准。
