安装Swagger CodeGen时出错

Question

我使用命令安装Swagger CodeGen

npm install swagger-codegen -g

所以我应该安装它，但是有一些错误/故障正在发生。每次我进去

swagger-codegen -v

我收到以下信息

“‘swagger codegen”不被识别为内部或外部命令、可操作的程序或批处理文件。

我不知道该怎么办。我该怎么解决这个问题？我正试图遵循一个教程，但指导员说明了他是如何安装程序的。

在GitHub下，这些指令没有意义

如果您正在寻找最新的稳定版本，您可以直接从Maven.org (至少是Java7运行时)获取它的先决条件：

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

我应该把这些放进命令行吗？试过了，没起作用

Answer 1

Swagger是一个Java应用程序，所以您必须安装Java。

SwaggerCodegen-2.x和3.x有两个版本。openapi: 3.0.0定义使用3.x，swagger: '2.0'使用2.x。

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

视窗

下载编译后的JAR文件：

• Codegen 3.x罐子在这里：https://oss.sonatype.org/content/repositories/releases/io/swagger/codegen/v3/swagger-codegen-cli/
• Codegen2.x罐子在这里：http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/

查找名为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

然后，您可以按以下方式运行codegen：

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

如果您没有Homebrew，请从Maven下载JAR文件，并按照上面对Windows的解释运行它。

CLI版本的替代方案

您还可以：

• 从装腔作势编辑器生成服务器和客户端代码(它有一个集成的代码)。
• 使用其REST API调用联机代码源。(示例)
• 使用Maven插件：swagger-codegen-maven-plugin。组ID为Codegen2.x的io.swagger，Codegen3.x的io.swagger.codegen.v3。

Answer 2

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