要在 VS Code 中高效利用 CodeGeex 插件，自动创建出精准匹配本地 API 的 Postman 测试脚本，核心关键在于为 AI 提供清晰的 API 规格说明。插件无法猜测您 /login 接口是接收 username 还是 email，也无法预知响应中的 access_token 是嵌套在 data.token 还是直接位于根对象。因此，充分的准备工作必不可少。
第一步：确保 CodeGeex 插件已正确安装并激活
在 VS Code 中打开扩展市场（快捷键 Ctrl+Shift+X），搜索 CodeGeex 并安装由 Tongyi Lab 发布的官方版本。安装完成后，请重启 VS Code。成功激活后，您将在编辑器底部状态栏看到一个 CG 图标。如果未发现该图标，请检查扩展是否已启用，或点击右下角的通知手动激活。
此步骤至关重要：未激活的插件不会响应任何指令，您后续所有的操作都将无效。
第二步：创建结构清晰的 API 接口描述文档
建议在项目根目录下新建一个 Markdown 文件，例如命名为 api-spec.md。在其中清晰、完整地描述您需要测试的接口，例如：
### POST /api/v1/login
- **请求体**（JSON 格式）：
```json
{ "email": "test@example.com", "password": "123456" }
```
- **成功响应**（HTTP 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 标签页直接运行的 JavaScript 测试脚本。要求：1. 验证状态码为 200；2. 验证响应体 code 字段等于 0；3. 提取 data.token 并存储为环境变量 accessToken；4. 断言 token 字段存在且为非空字符串。
输入完毕后按下回车。稍等片刻，CodeGeex 将输出完整的测试脚本代码。请完整复制所有输出内容，包括注释和外层的 pm.test 函数括号。
第四步：将生成的脚本部署到 Postman 中进行测试
在 Postman 中找到对应的请求（例如名为 “用户登录 - 有效凭据” 的 POST 请求），切换到 “Tests” 选项卡。
清空该选项卡内现有的任何代码，然后将从 CodeGeex 复制的脚本完整地粘贴进去。请注意检查是否引入了多余的空行或隐藏字符——Postman 对 JavaScript 语法非常敏感，一个符号错位就可能导致整个脚本无法执行。
点击 “Send” 按钮发送请求。如果 API 响应正确，您将在右侧的 “Test Results” 区域看到类似 “4/4 Passed” 的提示。如果结果显示失败或报出语法错误，通常是粘贴时引入了格式问题，尝试重新复制粘贴一次即可解决。