HTTP Client 文件需满足严格格式：后缀为.http或.rest、位于项目目录内、首行大写方法+空格+URL；JSON请求须Content-Type显式声明且body无语法错误；变量定义须符合命名规则并置于正确作用域。
HTTP Client 文件不执行，绿色甲虫图标不亮
根本不是插件没启用，而是文件没被识别为 HTTP 请求文件。WebStorm 只认 .http 或 .rest 后缀，且必须放在当前打开的项目目录内（桌面、下载目录无效）。
首行必须严格是大写方法 + 单个空格 + 完整 URL，比如：GET https://api.example.com/users。不能有注释、中文、全角空格、URL 编码错误（如中文路径要手动转成 %E4%BD%A0%E5%A5%BD），也不能以 // 或 # 开头。
- 文件重命名为
api.test.http后仍不亮？检查是否在项目根目录或子目录下，而不是临时文件夹 - 光标停在 GET 行却没反应？确认首行无隐藏字符（用十六进制编辑器或粘贴到 VS Code 查 BOM）
- 右键 Run ‘xxx.http’ 报错 “No run configuration”？说明文件格式未通过校验，先修复首行再试
POST JSON 请求总返回 400 或 415
绝大多数情况是 Content-Type 和 body 实际格式不一致，或者 JSON 本身有语法硬伤——HTTP Client 不做容错，错一个字符就失败。
Content-Type: application/json 必须显式写出，单独成行，前后无空格；body 必须顶格、无缩进、无 BOM、无尾逗号、key 和字符串值都用双引号。
立即学习“前端免费学习笔记（深入）”；
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
- 错误示例：
{"name": "Alice",}（尾逗号）、{name: "Alice"}（key 缺引号）、{"name":"Alice"\n}（换行后多空行） - body 是表单数据时，改用
Content-Type: application/x-www-form-urlencoded，且字段值需 URL 编码，如username=%E5%BC%A0%E4%B8%89 - 中文或特殊字符出现在 URL 路径中（如
/用户/1），必须手动编码，WebStorm 不自动处理
变量定义后提示 Cannot resolve variable
变量名和作用域规则非常刚性：只允许字母、数字、下划线；必须先定义、后引用；环境变量文件 http-client.env.json 必须放在项目根目录，且结构扁平。
正确写法是把 @base_url = https://dev.api.com 放在文件最顶部，或用独立的 ### 块声明；写在请求块内部（### 下面）只对该块生效。
- 变量名含点或横线（如
@auth-token或@api.host）会直接报错 - 引用写成
{{dev.base_url}}无效，http-client.env.json中只能是{"dev": {"base_url": "..."}}，引用时用{{base_url}} - 变量值为空（比如
@token =）不会报错，但请求发不出去，控制台只显示 “Variable 'token' is not defined”
调试 Vue 时想边改接口边测，但 .http 文件和源码不同步
HTTP Client 是纯文本请求工具，不感知 Vue 的 dev server 热更新或代理配置。它按字面发送请求，不会走 vue.config.js 里的 devServer.proxy。
如果后端接口走本地代理（如 /api/users → http://localhost:3000/users），你在 .http 文件里就得直接写目标地址 GET http://localhost:3000/users，而不是 GET /api/users。
- 别指望
.http文件能复用 Vue 的 axios 配置、拦截器或 token 自动注入逻辑 - 需要动态 token？用
@token = {{jwt_token}}并配合插件支持表达式，但更稳的方式是先从浏览器 DevTools 复制现成的 Authorization header - 复杂流程（如登录 → 提取 token → 调其他接口）建议拆成多个
###块，并用变量链式传递，但注意每个块是独立执行，不共享上下文
