VSCode本身不生成API代码，仅转译注释、配置或运行时接口为可读格式；真正生成代码依赖运行时库（如FastAPI、springdoc-openapi）或CLI工具（如OpenAPI Generator），插件仅作管道或预览器。
VSCode 本身不生成 API 代码，它只帮你把已有注释、配置或运行时暴露的接口“转成可读格式”或“补全模板”。真正能产出可用 API 代码的，是语言生态里的运行时库（如 FastAPI、springdoc-openapi）或 CLI 工具（如 OpenAPI Generator），VSCode 插件只是管道或预览器。
为什么你点“Generate API”没反应？
常见错误现象：Command 'OpenAPI: Generate' not found 或右键菜单压根没有该选项——这说明你装的插件不匹配当前文件类型，或没打开合法的 OpenAPI 文件。
- 插件不会主动扫描整个项目去“猜”接口；它只响应特定上下文：比如打开
openapi.yaml且文件开头含openapi: 3.0.3，或在 Spring Boot 项目中已启动服务并暴露了/v3/api-docs接口 - JavaScript/TypeScript 项目用
swagger-jsdoc时，必须提前在代码里写好definition对象和apis路径数组，VSCode 插件不执行 JS，只做静态扫描 - FastAPI 项目虽自带
/docs页面，但 VSCode 插件不会自动调用该路由；它需要你手动配置代理或使用 OpenAPI Generator CLI 拉取 JSON
真正能干活的组合：OpenAPI Generator CLI + vscode-openapi
这是目前最可控、语言支持最广的“从文档生成代码”路径。VSCode 不直接生成，但可以一键调用 CLI。
- 先确保本地已安装
openapi-generator-cli：npm install -g @openapitools/openapi-generator-cli - 在 VSCode 中安装
vscode-openapi插件（注意不是名字带 Swagger 却只做高亮的那个） - 右键点击合法的
openapi.yaml→ 选择OpenAPI: Generate Client→ 选语言（如typescript-axios或java）→ 指定输出目录 - 生成结果不含业务逻辑，只有接口定义、DTO 和请求封装；你要把它
import进项目，再配合自己的 service 层使用
Vue/React 前端调用 API 的快捷补全怎么来？
前端开发者常误以为“API 代码生成”是指 uni.request 或 axios.get('/user') 这类调用，其实这类补全靠的是类型系统 + snippets 联动，不是“生成”。
- 装
Vue VSCode Snippets后，输入vapi并 Tab 可展开一个带onMounted+axios.get的模板，但它不校验 URL 是否真实存在 - 要让
uni.showToast参数被提示、count最大值为 9 被捕获，必须装@uni-helper/uni-app-types并在tsconfig.json的compilerOptions.types中声明 - React 用户若用
swr或react-query，建议搭配openapi-typescript-codegenCLI 生成 hooks，再用 VSCode 的 TS 类型推导自动补全返回值
别忽略 $ref 和本地路径的坑
很多团队写的 openapi.yaml 会用 $ref: ./schemas/user.yaml 拆分结构，但 VSCode 插件默认不解析相对路径引用。
-
Swagger Viewer插件预览时，若看到Reference could not be resolved，大概率是$ref指向了未打开的文件，或路径用了 Windows 风格反斜杠\ - 解决办法：统一用正斜杠
/，所有被引用的 YAML 文件必须和主文件在同一工作区根目录下，或用openapi-validatorCLI 先合并成单文件再预览 - 更稳妥的做法是，在 CI 流程里用
openapi-cli bundle把所有$ref内联，再交给 VSCode 插件处理
复杂点在于：API 文档不是“生成出来就完事”，而是契约同步过程。VSCode 插件能省掉手动刷新浏览器、复制粘贴 JSON 的步骤，但无法替代你在 @Operation 注释里写清参数含义、在 components.schemas 里定义字段约束——这些才是别人能真正用起来的关键。
