thunder client需打开文件夹、重启vscode、认准rangav作者才能启动;发请求须带完整协议、选对method和body类型;环境变量需用预设键名、手动刷新请求才生效。

Thunder Client 能直接在 VSCode 侧边栏发起请求,不用切窗口、不传数据上云,但装完点不开、发不出、切不了环境——基本都是配置没踩对点。
安装后点闪电图标没反应?先看这三件事
不是插件坏了,是 Thunder Client 启动有前置条件:
- VS Code 必须打开一个文件夹(
File → Open Folder),空窗口下图标灰掉且无响应 - 安装后必须重启 VS Code(不是重载窗口),否则侧边栏入口不注册,
Developer: Reload Window不够用 - 确认插件作者是
rangav,别装错名字近似的仿冒扩展;右下角应出现「Thunder Client Ready」提示
发第一个请求就 404 或 Connection refused?检查请求行格式
Thunder Client 不接受裸 URL,也不自动补协议,错一个字符就静默失败:
- URL 必须带完整协议,
https://api.example.com/v1/users✅,api.example.com/v1/users❌ - HTTP method 下拉框要手动选对,不能靠默认值;POST 请求如果 Body 类型选成
form-data却粘了 JSON 字符串,后端收不到req.body - 如果用了
baseUrl变量,它的值末尾不能加斜杠:"baseUrl": "https://api.dev.example.com"✅,"https://api.dev.example.com/"❌(拼路径时会变双斜杠)
怎么配 dev/staging/prod 多环境并真正生效?
环境切换不是全局设置,而是按工作区绑定,且不会自动刷新已打开的请求标签页:
- 点右上角
Environments→+ New Environment,填的是标准 JSON,字段名必须是baseUrl、token、timeout等预设键,apiVersion这类自定义字段不会注入到请求中 - 切换环境后,已打开的请求 URL 不会自动更新——得手动点一次
Send或按Ctrl+Enter,否则仍用旧baseUrl - 环境配置存在工作区根目录下的
.thunder-collection/environments.json,别手改,全靠 UI 操作,否则格式错会导致整个环境列表消失
为什么切换环境后 Token 没自动带上?
Thunder Client 的 token 字段只用于自动注入 Authorization: Bearer xxx,但前提是请求里没手动写 Authorization 头:
- 如果请求 Headers 区域里已经写了
Authorization: Bearer abc123,插件会跳过自动注入,哪怕环境里配了token - 想让 token 生效,Headers 区域必须留空,或删掉已有
Authorization行 - Bearer 前缀是硬编码的,不支持
Basic或自定义 scheme;要换认证方式,得手动写 Header
最常被忽略的一点:Thunder Client 没有「请求历史自动关联环境」机制。你在一个环境下发的请求,切到另一个环境后重发,它不会记住你上次用的是哪个环境——每次切换都得重新确认当前生效的是谁。











