使用OpenAPI CLI Generator生成Vue项目遇错及方案问询

一、报错原因 #

OpenAPI Generator没有名为vue的官方生成器，你指定的生成器名称不正确。官方提供的Vue相关生成器有两个：

• vue2：用于生成Vue 2.x版本的前端项目/API客户端
• vue3-typescript：用于生成Vue 3.x + TypeScript的项目/API客户端

二、正确生成Vue项目的命令 #

根据你的Vue版本选择对应命令：

生成Vue 2项目 #

openapi-generator-cli generate -i C:\Users\Admin\Downloads\Temp\openapi.yaml -g vue2 -o my-vue2-project

生成Vue 3 + TypeScript项目 #

openapi-generator-cli generate -i C:\Users\Admin\Downloads\Temp\openapi.yaml -g vue3-typescript -o my-vue3-ts-project

你可以通过以下命令查看所有可用生成器，确认Vue相关选项：

openapi-generator-cli list

三、其他基于Swagger/OpenAPI生成Vue项目的方案 #

1. 使用Swagger Codegen #

Swagger Codegen与OpenAPI Generator同源，支持相同的Vue生成器，使用方式类似：

swagger-codegen generate -i C:\Users\Admin\Downloads\Temp\openapi.yaml -g vue2 -o my-vue-project

2. Vue CLI插件vue-cli-plugin-openapi #

适合在现有Vue项目中快速集成API客户端：

• 若未创建Vue项目，先执行：vue create my-vue-project
• 进入项目目录，安装插件：vue add openapi
• 按照提示配置OpenAPI文件路径，插件会自动生成API请求代码并集成到项目中

3. 手动结合openapi-typescript与axios #

适合需要高度自定义API请求逻辑的场景：

• 安装依赖：

  npm install openapi-typescript axios --save-dev
  

• 生成TypeScript类型定义：

  npx openapi-typescript C:\Users\Admin\Downloads\Temp\openapi.yaml --output src/api/types.ts
  

• 基于生成的类型封装axios请求，获得完整的类型提示

内容的提问来源于stack exchange，提问作者Rahul Parab