使用golang評論生成Swagger規範

Question

我正在嘗試爲使用Swagger編寫的使用golang編寫的REST API創建文檔。我一直在遵循本指南：https://goswagger.io/generate/spec.html這樣做，並且已經能夠從我的主文件中的評論中創建json文件，但是我不知道如何創建將轉化爲實際的swagger規範的.yaml文件。我已按照頁面上的說明進行操作，並在我的主文件中包含//go:generate swagger generate spec。任何人都知道如何創建.yaml文件？

Answer 1

在這個階段生成的規格是json而不是yaml，並不是說它不能做yaml，但現在它只生成json。

你可以用你的註釋主要包：//go:generate swagger generate spec -o swagger.json

那麼你就可以生成與規格：go generate當你在主包的文件夾中。如果您的主包不是您的項目根目錄，而是像$project_root/cmd/my-server那麼您可以從項目根目錄運行go generate ./cmd/my-server。