安装 Swagger CodeGen 时遇到问题

Trouble installing Swagger CodeGen

我使用命令安装了 Swagger CodeGen

npm install swagger-codegen -g

所以我应该安装它,但有一些 error/glitch 正在进行。每次输入

swagger-codegen -v

我收到以下消息

'swagger-codegen' 未被识别为内部或外部命令, 可运行的程序或批处理文件。

我不知道该怎么办。我应该如何解决这个问题?我正在尝试按照教程进行操作,但讲师从未展示他如何安装程序。

在GitHub下,指令没有意义

先决条件 如果你正在寻找最新的稳定版本,你可以直接从 Maven.org 获取它(Java 至少 7 runtime):

wget http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.3.1/swagger-codegen-cli-2.3.1.jar -O swagger-codegen-cli.jar

java -jar swagger-codegen-cli.jar help

对于 Windows 用户,您需要安装 wget 或者您可以在 PowerShell (3.0+) 中使用 Invoke-WebRequest,例如

Invoke-WebRequest -OutFile swagger-codegen-cli.jar http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.3.1/swagger-codegen-cli-2.3.1.jar

我应该将它们放在命令行中吗?试过了,没用

此模块在通过 npm install swagger-codegen -g 安装时不会创建可执行文件,这就是您看到错误的原因。请参阅 https://github.com/swagger-api/swagger-codegen/blob/master/README.md#prerequisites 安装说明

Swagger Codegen 是一个 Java 应用程序,因此您必须安装 Java。

Swagger Codegen 有两个版本 - 2.x 和 3.x。使用 3.x 用于 openapi: 3.0.0 定义,使用 2.x 用于 swagger: '2.0'.

正在安装 Swagger Codegen CLI(命令行版本)

Windows

下载编译好的JAR文件:

查找名为 swagger-codegen-cli-<version>.jar 的文件,例如如果你需要 v.2.3.1:
http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.3.1/swagger-codegen-cli-2.3.1.jar


要 运行 代码生成器,请使用:

java -jar c:\path\to\swagger-codegen-cli-<version>.jar <args>

(为简单起见,您可以将 swagger-codegen-cli-<version>.jar 重命名为 swagger-codegen-cli.jar。)

Mac

使用 Homebrew 安装:

# Codegen 3.x
brew install swagger-codegen

# Codegen 2.x
brew install swagger-codegen@2

然后你可以运行代码生成为:

swagger-codegen <args>
swagger-codegen@2 <args>

如果您没有 Homebrew,请从 Maven 下载 JAR 文件,然后 运行 按照上面 Windows.

的说明下载它

CLI 版本的替代方案

您还可以:

  • Swagger Editor 生成服务器和客户端代码(它有一个集成的代码生成器)。
  • 使用其 REST API. ()
  • 调用在线代码生成器
  • 使用 Maven 插件:swagger-codegen-maven-plugin。 Codegen 2.x 的群组 ID 为 io.swagger,Codegen 3.x 的群组 ID 为 io.swagger.codegen.v3