如何在 VS Code 中通过 CodeGeex 快速编写针对 API 接口的 Postman 测试脚本

要在 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，说明粘贴时带进了不可见的格式符号，重新复制粘贴一次通常就能解决。