VSCode中Thunder-Client插件配置与API接口调试方法-VSCode-PHP中文网

thunder client 能在 vscode 里直接发请求，但装完点不开、发不出、变量不替换、415/404/401 频出——问题几乎全出在配置细节上，不是插件不行，是它不自动补头、不智能拼参、不 fallback 解码。

vscode中thunder-client插件配置与api接口调试方法

Thunder Client 能在 VSCode 里直接发请求，但装完点不开、发不出、变量不替换、415/404/401 频出——问题几乎全出在配置细节上，不是插件不行，是它不自动补头、不智能拼参、不 fallback 解码。

Thunder Client 不是装完就能用，它依赖 VSCode 的工作区上下文和进程初始化：

415 不是后端拒收，是 Thunder Client 没把请求“说清楚”：

Body 类型必须切到 raw → JSON（不是 Text、Form Data 或 GraphQL）
Headers 栏必须显式添加：Content-Type → application/json
JSON 内容要合法：{"name": "alice", "id": 1} ✅，{name: "alice"} ❌，末尾多逗号、包在引号里、用中文引号都会触发解析失败
后端也要匹配：Express 需 app.use(express.json())；Fastify 默认不解析 JSON，得配 bodyLimit 和 jsonSchema

Thunder Client 的 Params 栏只是参数编辑器，不是 URL 构建器：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

填完 id=123 后，必须点右上角 Add to URL 按钮，否则等于白填
最稳写法是直接写完整 URL：https://api.example.com/users?id=123&active=true
中文或特殊字符（空格、&、=）要自己 URL 编码：name=%E5%BC%A0%E4%B8%89；Thunder Client 不自动处理
参数多且常变？改用环境变量：{{base_url}}/users?id={{user_id}}，再在 Environment 里定义 user_id = 123

变量名写对、值设对，不代表它就起作用。Thunder Client 不提示“替换失败”，只默默发错请求：

当前环境必须被选中：看 VSCode 左下角状态栏是否显示 Environment: dev，点击可切换
变量名必须完全匹配：大小写敏感，只允许字母、数字、下划线；base-url ❌，base_url ✅
URL 和 Headers 中必须用双大括号包裹：{{base_url}}、Authorization: Bearer {{token}}
第一次配置后，务必点请求左下角的 Preview，确认实际发出的 URL 和 Headers 是否已替换
注意：token 字段只用于自动注入 Authorization: Bearer xxx，前提是 Headers 区域没手动写 Authorization 头；写了就跳过自动注入