0

0

如何利用VSCode进行API测试与接口调试?【教程】

幻影之瞳

幻影之瞳

发布时间:2026-01-23 15:25:34

|

778人浏览过

|

来源于php中文网

原创

VSCode通过REST Client、Thunder Client和cURL三种方式实现API测试:REST Client轻量快捷但无状态管理;Thunder Client支持环境切换、自动鉴权和简易断言;cURL配合终端与jq适合临时验证和CI场景。

如何利用vscode进行api测试与接口调试?【教程】

VSCode 本身不内置 API 测试功能,但通过轻量、可组合的扩展(而非安装 Postman 类重型工具),能高效完成绝大多数接口调试任务。关键在于选对扩展、配好环境、避免硬编码敏感信息。

用 REST Client 扩展直接发请求

这是 VSCode 中最接近“开箱即用”的 API 调试方式:在 .http.rest 文件里写请求,按 Ctrl+Alt+R(Windows/Linux)或 Cmd+Alt+RmacOS)即可执行。

  • 安装官方扩展 REST Client(作者:Huachao Mao)
  • 新建文件,保存为 test.http,内容示例如下:
GET https://jsonplaceholder.typicode.com/posts/1
Content-Type: application/json

执行后右侧会弹出响应面板,支持查看状态码、Headers、JSON 格式化结果。

  • 支持变量:用 {{baseUrl}} + @baseUrl = https://api.example.com 定义顶部变量,便于多环境切换
  • 不支持 cookie 持久化或登录态自动管理,需手动提取 Set-Cookie 并在后续请求中加 Cookie: ...
  • 无法做断言或自动化校验,纯手工验证响应内容

用 Thunder Client(轻量版 Postman)做带状态的调试

Thunder Client 是 VSCode 内嵌的类 Postman 工具,优势是自带环境管理、请求历史、基础断言和 Token 自动注入。

  • 安装扩展后,点击侧边栏 Thunder Client 图标,新建 Request
  • 填写 URL、Method、Headers 后,可点击 Save to Collection 归类,再通过 Environment 切换 dev/staging 等配置
  • 登录后,它会自动把 Authorization: Bearer xxx 保存到当前环境,后续请求勾选 Auto Add Auth 即可复用
  • 注意:它的“Tests”脚本用的是简易 JS 语法,不支持 async/await 或外部库,断言只能靠 pm.response.code === 200 这类原始判断
  • 导出集合是 JSON 格式,但无法直接导入 Postman 的 .json collection v2.1 —— 需先在 Postman 中导出为 v2.0 兼容格式

用 cURL 命令 + 终端快速验证(适合 CI 或临时查问题)

当需要复现某个线上报错、或他人给了一段 curl 命令时,在 VSCode 内置终端执行最直接,且可配合 jq 快速提取字段。

知料万语
知料万语

知料万语—AI论文写作,AI论文助手

下载
  • 确保系统已安装 curljq(macOS 可用 brew install jq;Windows 推荐 choco install jq
  • 把命令粘贴进 VSCode 的 Terminal,例如:
curl -X POST https://api.example.com/login \
  -H "Content-Type: application/json" \
  -d '{"username":"test","password":"123"}' | jq '.token'
  • 敏感参数(如密码)不要硬写在命令里,改用 read -s password(Linux/macOS)或 set /p password=(Windows CMD)交互输入
  • VSCode 终端默认使用 login shell,某些 PATH 设置可能不生效;若提示 command not found,检查终端类型(Ctrl+Shift+P → Terminal: Select Default Profile),切到 zshbash

避免把 token 或密钥写死在代码或请求文件中

所有扩展(REST Client / Thunder Client)都支持从环境变量读值,这是防止泄露的关键习惯。

  • 在 VSCode 的 settings.json 中添加:
"rest-client.environmentVariables": {
  "local": {
    "token": "xxx",
    "baseUrl": "http://localhost:3000"
  }
}

然后在 .http 文件中写 Authorization: Bearer {{token}},运行时自动替换。

  • 更安全的做法是让 token 由脚本动态生成(如调用登录接口后提取),但 REST Client 不支持跨请求变量传递;此时应退回到 Thunder Client 的 Tests + Environment 更新逻辑,或直接切到终端用 curl + jq + export 链式处理
  • 千万别把 .httpthunder-collection.json 提交到 Git —— 至少在 .gitignore 加上 *.http**/thunder-tests/**

真正麻烦的不是发请求,而是维护多套环境下的凭证流转和响应结构变化;越早用变量抽象,后期改起来越省力。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

417

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

76

2025.09.10

软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

439

2023.10.13

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6423

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

346

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

411

2024.02.23

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

0

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.7万人学习

Git 教程
Git 教程

共21课时 | 2.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号