最稳入口是Tools → Test RESTful Web Service；需确认右上角有环境选择器，否则检查.rest-client.env.json是否存在且格式合法；.http文件首行必须为完整请求行，空行后写headers，JSON body须顶格无BOM；变量名须与env文件严格一致。
怎么打开RESTful面板才有效
直接点 Tools → Test RESTful Web Service 是最稳的入口，别依赖右键菜单或快捷键——某些 Debian 桌面环境（比如 GNOME Wayland）下快捷键会冲突，右键新建可能生成空文件而不激活客户端。面板弹出后，第一眼确认右上角有没有环境选择器（显示 dev 或 default），没有就说明项目根目录下缺 .rest-client.env.json 或 JSON 格式非法。
.http 文件写错哪一行就整个失效
首行必须是完整请求行：GET https://api.example.com/users，不能带注释、不能缩进、不能空格多余；空行之后才能写头，例如：Content-Type: application/json；JSON 请求体必须顶格、无空行、无 BOM —— 你复制粘贴过来的 JSON 如果开头有不可见字符，POST 发出去就是 400；如果用了变量 {{base_url}}，但 .rest-client.env.json 里定义的是 "api.base_url"，PhpStorm 不报错，只是卡住不动，日志里只显示 Cannot resolve variable 'base_url'。
POST/PUT 请求发不出去？先盯死这三处
-
Content-Type头没写，或写成application/json; charset=utf-8—— PhpStorm 默认不认带参数的 MIME 类型，删掉; charset=utf-8就行 - 请求体选了
Form模式却粘了 JSON 字符串，或者选了Raw却写了username=john&password=123—— 模式和内容必须严格匹配 - 用了
multipart/form-data—— PhpStorm 的 HTTP Client 对它支持极弱，boundary 不自动生成，字段顺序容易错，真要传文件，直接切到终端跑curl更可靠
响应太大时怎么避免卡死
大响应（比如返回几 MB 日志或二进制）会让 PhpStorm 界面假死。解决办法有两个：一是加 Accept: text/plain 头，让服务端降级返回纯文本；二是用 ### 分隔多个请求，在同一个 .http 文件里把大响应请求单独拆开，执行时只点它那一块的绿色三角；三是响应面板右上角点齿轮图标 → 关闭 Show response in editor，改用 View as text 流式加载。
client.global.set() 设的变量只在当前请求块内有效，跨 ### 分隔就不继承；而环境变量 {{var}} 虽然全局可用，但一旦拼错名或值为空，请求根本不会发，连 4xx 都看不到。 
