webstorm http client 需严格遵循文件类型识别、语法格式、变量作用域和 oauth 配置规则：仅 .http 文件首行为合法请求或通过 new → http request 创建才启用运行；空格、换行、编码、json 格式、url 编码、变量声明位置与命名、响应提取语法及 http-client.env.json 路径结构均须精准匹配，否则静默失败。
WebStorm 内置 HTTP Client 不是“装完就能用”的工具，它对文件结构、语法格式、变量作用域极其敏感——稍有偏差就看不到绿色执行箭头、报 Unresolved variable、解析 JSON 失败或静默丢 headers。
新建 .http 文件为什么没反应？
根本原因不是插件没开，而是 WebStorm 没把文件识别为 HTTP Request 类型。它只在两种情况下自动绑定运行能力：一是通过右键 → New → HTTP Request 创建；二是文件后缀为 .http 且首行是合法请求（如 GET https://），不能是注释、空行或变量声明。
- 别用
New → File建test.http，IDE 可能仍当纯文本处理 - 已建错的文件，右键 → Override File Type → HTTP Request 可临时修复
- 临时测试优先用 Scratch File（
Ctrl+Alt+Shift+Insert，选 HTTP Request 类型）：不进 Git、自动记录响应时间/状态码、不怕误提交
写第一个请求就 400 或解析失败？检查这几点
HTTP Client 对格式是“零容忍”：不是“差不多”，而是“差一点就挂”。常见错误都藏在空格、换行、引号和编码里。
-
GET必须大写，URL 必须带协议（https://），末尾不能有多余空格或不可见字符（比如全角空格） - Header 必须顶格写：
Content-Type: application/json，前后不能有空格，也不能缩进 - JSON body 必须顶格、无 BOM、UTF-8 编码、无 trailing comma、字符串用双引号——
{ "name": "Alice", }会直接报invalid JSON - 中文或特殊字符在 URL 中必须手动 URL 编码：
https://api.com/用户要写成https://api.com/%E7%94%A8%E6%88%B7
变量怎么定义才跨请求生效？
变量不是写在哪都管用，作用域由位置和语法决定。写错位置，{{host}} 就永远是未定义。
- 全局变量必须放在文件最顶部，或用独立的
###块声明：@host = https://api.example.com - 别把
@token写在某个请求块（###后）下面——那只是局部变量，只对该块生效 - 变量名只能含字母、数字、下划线：
@api_url✅，@api-url❌，@auth.token❌ - 从响应提取值必须用
>语法：Authorization: {{token}}下一行写> { % response.body.token % }，少一个符号都不行
OAuth2 自动拿 token 总是 401？
HTTP Client 的 OAuth 支持完全依赖配置驱动，不是填个 client_id 就能跑通。它根本不读请求里的参数，只认 http-client.env.json 文件里的结构。
- 必须在项目根目录放
http-client.env.json，内容要严格嵌套：{"dev": {"Security": {"Auth": {"my-api": {"Type": "OAuth2", "Grant Type": "Authorization Code", "Client ID": "xxx"}}}}} - 请求中写
Authorization: Bearer {{$auth.token("my-api")}}——注意是双$、括号、引号全不能少 - 首次运行会弹非模态浏览器窗口，你可以在 WebStorm 里切窗口操作，但千万别关掉那个窗口，否则 token 获取中断，后续全 401
- Postman 的 pre-request script 和 test script 完全不兼容，得重写为
###后的 JavaScript 响应处理器，pm.*全换成client.*或原生 JS
最容易被忽略的是：环境变量文件路径、变量命名规则、响应提取语法这三处，它们不出错时一切正常，一出错就没有任何提示性报错，只有 Unresolved variable 或 401 ——得逐行比对文档格式，而不是猜逻辑。
