VS Code中用CodeGeex快速编写Postman API测试脚本
在VSCode中通过CodeGeex生成Postman测试脚本,需先激活插件并创建包含HTTP方法、路径及示例请求响应体的api-spec.md文件。全选文件内容后使用CodeGeex输入生成指令,将输出的JavaScript脚本粘贴至Postman对应请求的Tests标签页,发送请求即可验证测试结果。
要在 VS Code 中用 CodeGeex 自动生成适配本地 API 的 Postman 测试脚本,前提是让插件能够“看到”接口的定义——它无法凭空猜出你的 /login 需要传 username 还是 email,也不能知道响应里的 access_token 是藏在 data.token 里还是直接放在根层级。因此,准备工作必不可少。

确保 CodeGeex 插件已安装并激活
打开 VS Code 扩展市场(Ctrl+Shift+X),搜索 CodeGeex 并安装官方版本(Publisher: Tongyi Lab)。安装完成后重启 VS Code,底部状态栏会显示 CG 图标。如果图标未出现,说明插件尚未激活——需点击右下角通知或手动启用。
这一步不可省略:未激活的 CodeGeex 不会响应任何指令,后续的所有提示操作都将无效。
准备一份结构清晰的 API 描述文件
在项目根目录新建 api-spec.md 文件,使用 Markdown 将待测试的接口信息完整写出,示例如下:
### POST /api/v1/login
- 请求体(JSON):
```json
{ "email": "test@example.com", "password": "123456" }
```
- 成功响应(200):
```json
{ "code": 0, "msg": "ok", "data": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." } }
```
关键点在于必须包含三项内容:HTTP 方法、路径、示例请求体以及示例成功响应体。缺少任何一项,CodeGeex 生成的脚本很可能会出现断言失败或字段提取错误,最终仍需手动调整。
触发 CodeGeex 生成 Postman 测试脚本
打开刚才创建的 api-spec.md 文件,全选内容(Ctrl+A),右键选择“Ask CodeGeex”(或使用快捷键 Ctrl+Alt+L)。
在弹出的输入框中,逐字粘贴以下指令(包括标点符号):
请根据上述 API 描述,生成一段可在 Postman Tests 标签页直接运行的 Ja vaScript 测试脚本。要求:1. 验证状态码为 200;2. 验证响应体 code 字段等于 0;3. 提取 data.token 并存为环境变量 accessToken;4. 断言 token 字段存在且非空字符串。
按下回车后等待几秒,CodeGeex 会输出完整的脚本。将输出的所有内容复制下来,不要删除任何一行——包括注释和 pm.test 外层的那对括号。
将生成的脚本粘贴到 Postman 对应请求的 Tests 标签页
在 Postman 中找到目标请求(例如名为“Login - Valid User”的 POST 请求),切换到 Tests 选项卡。
清空原有内容,将复制的脚本完整粘贴进去。注意检查是否存在多余空行或隐藏字符——Postman 对语法敏感,括号错位会导致整个脚本无法执行。
点击 Send 发送请求。若响应正确,右侧 Test Results 下会显示 4/4 Passed;若显示 0/4 或报 SyntaxError,说明粘贴时带入了不可见格式符号,重新复制粘贴一次通常即可解决。
