Fast HTTP

在 VS Code 中发现 Spring Boot Controller 接口、生成请求并直接发送 HTTP 请求。

Fast HTTP 使用 Java 语法树分析 Controller，无需启动 Spring Boot 服务即可整理接口；需要联调时，可以从 CodeLens、右键菜单或 API Explorer 打开请求编辑器。

安装

VS Code Marketplace

在 VS Code 扩展视图中搜索 Fast HTTP，或者执行：

code --install-extension codesbamboo.fast-http

离线安装 VSIX

code --install-extension .\fast-http-win32-x64-0.1.1.vsix --force

当前首发包支持 Windows x64，要求 VS Code 1.95.0 或更高版本。

快速开始

打开包含 Spring Boot Controller 的 Java 工作区。
打开任意 Controller 文件，或点击 Activity Bar 中的 Fast HTTP 图标。
通过 CodeLens、编辑器右键菜单或 API Explorer 选择接口。
确认请求地址、参数、Headers 和 Body 后发送请求。

核心功能

从 Spring Boot Controller 方法生成 HTTP 请求
Java 编辑器 CodeLens 与右键菜单快捷入口
API Explorer 工作区接口树、增量刷新、搜索和源码定位
支持大型 Controller 与 DTO 源文件的分块语法树解析
识别 @RequestMapping、@GetMapping、@PostMapping 等 Spring 映射
识别 @PathVariable、@RequestParam、@RequestHeader、@RequestBody
请求编辑器支持 URL、Query、Headers、JSON Body 和 Multipart
发送真实 HTTP 请求并展示状态码、响应头和响应体
导入浏览器 Copy as cURL 生成的命令
环境配置和 {{variable}} 变量替换
导出 Markdown、OpenAPI JSON 和 OpenAPI YAML
按 Controller 或整个工作区批量导出 OpenAPI

API Explorer

点击 Activity Bar 中的 Fast HTTP 图标即可打开 API Explorer。插件扫描 src/main/java 下的 Java 文件，并按以下结构展示：

Controller
└── HTTP Method / Path

点击接口节点可打开请求编辑器。Controller 文件保存、新建或删除后，API Explorer 会自动更新，并尽量只重新解析发生变化的文件。

点击右上角搜索按钮或按 Ctrl+Alt+F 可以按照以下内容检索：

Controller 名称
接口摘要与描述
Java 方法名
URL
HTTP Method

多个关键词采用全部匹配。例如输入 approval post，会筛选同时包含两个关键词的接口。

选择搜索结果会打开 Controller 源码并定位到对应方法；结果右侧的按钮可以直接打开请求编辑器。扫描失败时，可通过 API Explorer 的信息按钮查看失败文件和错误原因。

环境配置

运行命令面板中的 Fast HTTP: Create Local Environment Configuration，插件会在工作区创建：

.fast-http/
└── environments/
    └── local.json

示例：

{
  "name": "local",
  "baseUrl": "http://localhost:8080",
  "headers": {
    "Content-Type": "application/json"
  },
  "variables": {
    "token": ""
  }
}

可以在同一目录增加 test.json、prod.json 等环境文件。打开请求时，插件会替换 URL、Query、Headers 和 Body 中的 {{baseUrl}}、{{token}} 等变量。

也可以通过设置项 fastHttp.defaultBaseUrl 调整默认 Base URL。

请勿将真实 Token、密码或其他密钥提交到版本库。

导入 cURL

请求编辑器支持粘贴浏览器 Copy as cURL 生成的命令，并识别：

请求方法：-X / --request
请求头：-H / --header
请求体：-d / --data / --data-raw / --data-binary / --data-urlencode
URL：--url 或位置参数
基础认证：-u / --user

未指定方法时，带请求体默认使用 POST，否则使用 GET。URL 中的查询参数会自动拆分到 URL Params，JSON 请求体会被格式化后回填。

文档导出

请求编辑器和 API Explorer 支持将接口导出到：

.fast-http/
└── exports/
    ├── *.md
    ├── *.json
    └── *.yaml

OpenAPI 文档使用 OpenAPI 3.0.3，可包含 Path、Query、Header、JSON Body 和 Multipart Body 信息。

当前支持示例

@RestController
@RequestMapping("/api/users")
public class UserController {
    @PostMapping("/create")
    public User create(
        @RequestParam("name") String name,
        @RequestBody User user
    ) {
        return user;
    }
}

插件会生成：

POST http://localhost:8080/api/users/create

填写请求参数和 JSON Body 后，点击“发送请求”即可查看响应。

数据、网络与隐私

插件会读取工作区 Java 源码以发现 Controller 接口
环境和导出文件保存在工作区 .fast-http 目录
请求历史保存在 VS Code globalState
只有在用户确认发送后，插件才会向目标地址发起 HTTP 请求
插件不会自动将源码或请求内容上传到第三方服务
当前请求历史可能包含完整请求信息，请避免保存真实密钥
不受信任工作区中插件默认禁用

支持范围

Spring Boot Java Controller
Windows x64
VS Code 1.95.0 或更高版本
HTTP GET、POST、PUT、DELETE、PATCH

由于解析器依赖原生 tree-sitter 模块，macOS、Linux 和其他 CPU 架构将在完成对应平台验证后发布。

问题反馈与参与开发

仓库开发规则和编码代理约束维护在 CONTRIBUTING.md 与 AGENTS.md 中，不再放入 Marketplace 产品介绍。