webstorm http client 要运行需同时满足：文件后缀为 .http/.rest、首行为合法请求行（如 get https://）、ide 识别为 http request 类型；新建应选 new → http request 或手动创建后确保首行合规，否则无执行按钮。
WebStorm 的 HTTP Client 不是点开文件就能发请求的“调试器”，它必须满足三个硬性条件：文件后缀是 .http（或 .rest），首行是合法请求行（如 GET https://），且该文件类型已被 IDE 正确识别为 HTTP Request。缺一不可，否则连绿色执行箭头都不会出现。
怎么建文件才能让 WebStorm 认出它是可运行的 HTTP 请求？
新建方式错了，90% 的问题就埋下了。WebStorm 只在两种情况下自动绑定运行逻辑：
- 右键项目 → New → HTTP Request（推荐，IDE 自动设对文件类型、编码、语法高亮）
- 手动创建
test.http文件，但第一行必须是完整请求，比如GET https://httpbin.org/get—— 不能是空行、注释、变量声明，也不能是小写的get或缺协议的httpbin.org/get
常见踩坑：
- 用 New → File 建
api.http，结果 IDE 当纯文本处理，没高亮、没补全、没运行按钮 - 建完文件先写注释或
@host = ...，再写请求 —— 首行不是请求，直接失效 - 从
.txt改后缀成.http，IDE 缓存未刷新，仍按文本解析
已建错？右键文件 → Override File Type → HTTP Request 可临时修复；临时测试更建议用 Scratch File（Ctrl+Alt+Shift+Insert → HTTP Request），不进 Git、自动记响应时间、不怕误提交。
发起 GET/POST 请求时，哪些格式细节会直接导致静默失败或 400？
HTTP Client 对空格、换行、引号、编码是“零容忍”，不是报错，而是不执行或返回 400/415 —— 因为它根本没正确解析你的请求。
-
GET和POST必须大写，URL 必须带协议（https://），末尾不能有多余空格或不可见字符（比如全角空格） - Header 必须顶格写：
Content-Type: application/json，前后不能有空格，也不能缩进 - JSON body 必须顶格、UTF-8 无 BOM、双引号、无 trailing comma：
{ "name": "Alice" }✅，{ "name": "Alice", }❌，{'name': 'Alice'}❌ - 中文或空格出现在 URL 路径或 query 中必须手动 URL 编码：
https://api.com/%E7%94%A8%E6%88%B7，不是https://api.com/用户 - POST 请求必须显式写
Content-Type头；body 和 headers 之间必须用空行隔开，不能靠缩进或注释合并
怎么安全复用 base_url、token 这类值，而不是到处硬编码？
变量不是写在哪都生效，作用域由位置和语法决定。写错位置，{{host}} 就永远是 Unresolved variable。
- 全局变量必须放在文件最顶部，或用独立的
###块声明：@host = https://api.example.com - 别把
@token写在某个请求块（###后）下面——那只是局部变量，只对该块生效 - 变量名只能含字母、数字、下划线：
@api_url✅，@api-url❌，@auth.token❌ - 从响应提取 token 必须用
>语法：Authorization: {{token}}下一行写> { % response.body.token % }，少一个符号都不行 - Bearer Token 推荐这样写：
Authorization: Bearer {{token}}，注意Bearer后有一个空格
OAuth 2.0 怎么配才能自动拿 token，而不是手动复制粘贴？
OAuth 不是填个 client_id 就能跑通的。它依赖一个独立的 JSON 环境配置文件 http-client.env.json，且路径、结构、调用语法必须严丝合缝。
-
http-client.env.json必须放在项目根目录（或通过 Settings 指定路径），内容类似：{"dev": {"Security": {"Auth": {"my-api": {"Type": "OAuth2", "Grant Type": "Authorization Code", "Client ID": "xxx"}}}}} - 请求中必须用
{{$auth.token("my-api")}}（注意是双$+ 括号 + 引号），写成$auth.token或{{token}}都会报Unresolved variable - 首次运行会弹出非模态浏览器窗口，你仍可在 WebStorm 切窗口、复制密码，但别关掉它，否则 token 获取中断，后续请求全 401
- token 获取成功后，可在 Services → HTTP Client Auth 工具窗口里查看 access/refresh token，也可手动刷新
真正容易被忽略的是：变量作用域和 OAuth 配置文件的路径绑定。很多人把 http-client.env.json 放错目录，或在 .http 文件里漏写 $，结果卡在 401 却查不到原因 —— 它不会告诉你“配置文件没找到”，只会静默失败。
