golang中使用swagger遇到的一些问题

最新推荐文章于 2024-05-24 10:34:08 发布

活火石

最新推荐文章于 2024-05-24 10:34:08 发布

阅读量2.2k

点赞数

分类专栏： bug 文章标签： golang macos 开发语言

本文链接：https://blog.csdn.net/weixin_42886824/article/details/125341370

版权

bug 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

1. 下载swag，但是我们在$GOROOT/bin下没有发现swag二进制文件

方式一
$ go get -u github.com/swaggo/swag/cmd/swag

方式二
# 1.16 or newer
$ go install github.com/swaggo/swag/cmd/swag@latest

2. mac 下swag init执行报错zsh: command not found: swag

# 1. 检查是否存在swag执行文件
ls ~/go/bin.      # 查找GOPATH下是否存在swag二进制文件

# 2. 检查～/.zshrc 没有引入go的执行路径，修改加入
export PATH="/User/xxxx/go/bin":$PATH

# 3. 刷新一下
source ~/.zshrc

第一个问题解决是通过官网去解决的
第二个问题解决是通过度娘去解决的，复制了别人的解决方法

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

活火石

关注关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
打赏
1
评论
golang中使用swagger遇到的一些问题

使用go-swag的遇到的一些问题
复制链接

扫一扫

专栏目录

Go语言使用swagger生成接口文档的方法

09-16

主要介绍了Go语言使用swagger生成接口文档的方法，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下

gin使用 swag 提示： bash: swag: command not found

m0_52896752的博客

04-06

1694

gin使用 swag 提示： bash: swag: command not found

1 条评论您还未登录，请先登录后发表或查看评论

zsh: command not found: swag swag无法正常使用

wwxtt的博客

02-09

1321

zsh: command not found: swag swag无法使用

golang windows环境下集成swag的步骤

最新发布

fang0604631023的博客

05-24

405

golang windows环境下集成swag的步骤

swag 提示 zsh: command not found: swag

____

08-18

6472

swag 执行报错 zsh: command not found: swag 解决办法查看是否存在 swag 执行文件 $ cd ~/go/bin $ ls swag 检查 ~/.zshrc 没有引入go的执行路径，修改加入 export PATH="/Users/XXX/go/bin:$PATH" 再导入 source ~/.zshrc 即可 ...

【Swago】swag init无法启动的问题

weixin_44522586的博客

08-24

1921

swag init错误解决办法

Golang: Gin Swagger 配置

Allan_shore_ma的博客

03-04

811

Gin Swagger 配置 swagger是一套基于OpenAPI规范构建的开源工具，使用RestApi。swagger-ui 呈现出来的是一份可交互式的API文档，可以直接在文档页面尝试API的调用。 gin-swagger 是基于注释生成 API 文档，项目地址:https://github.com/swaggo/swag。

golang-swaggerui-example:Golang的SwaggerUI生成示例

05-14

Golang-swaggerui-example是一个示例存储库，用于在您的Golang项目中使用SwaggerUI设置API文档。详细说明可在。 API互动可以通过访问localhost：8080 / swaggerui /访问SwaggerUI，有关如何服务/ swaggerui的详细...

mswagger:使用golang生成swagger 2.0 json文件

05-17

使用swagger-ui修复某些字段类型的映射。用法在main.go中发表评论 // @Version 1.0.0 // @Title Backend API // @Description API usually works as expected. But sometimes its not true. // @BasePath / // @...

Golang中使用JSON的一些小技巧分享

12-31

有的时候上游传过来的字段是string类型的，但是我们却想用变成数字来使用。本来用一个json:”,string” 就可以支持了，如果不知道golang的这些小技巧，就要大费周章了。参考文章： JSON and struct composition in...

golang中使用mongo的方法介绍

09-20

主要给大家介绍了关于golang中使用mongo的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

python golang中grpc 使用示例代码详解

09-16

主要介绍了python golang中grpc 使用,本文通过示例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下

goswagger调用失败

jigetage的专栏

05-22

845

通过 swagger generate spec -o ./swagger.json命令生成swagger.json文件，命令运行失败，提示在GOROOT和GOPATH中都找不到各种go依赖包，原因是goswagger在寻找依赖包时不会从go的环境变量中寻找GOROOT GOPATH路径，而是在系统的环境变量中找GOROOT和GOPATH路径，所以需要设置系统环境变量。Linux下编辑vim ~/...

【swag】安装 swag 后，找不到 swag.exe

这里主要记录一些学到的新知识

08-15

942

在项目中成功 go get 安装 swag 的代码后，检查 swag 版本时输入 swag -v 提示 swag 不是内部或外部命令，也不是可运行的程序。进一步检查 GOPATH\bin 目录，没有找到 swag.exe 文件，所以 swag -v 不起作用。

golang restful 框架之 go-swagger

hatlonely的专栏

02-09

7098

restful 是这些年的高频词汇了，各大互联网公司也都纷纷推出了自己的 restful api，其实 restful 和 thrift，grpc 类似，就是一种协议，但是这种协议有点特殊的就是使用 http 接口，返回的对象一般是 json 格式，这样有个好处，就是可以供前端的 js 直接调用，使用非常方便，但 http 本身并不是一个高效的协议，后端的内部通信还是使用 grpc 或者 thri...

Golang项目自动生成swagger格式接口文档方法（二）

路多辛的所思所想

03-06

649

可以看出如果是使用第二种展示方式的话，上篇介绍的内容就够了。如果要实现第一和第三种方式，项目就需要集成swagger服务了。主流的三方接口文档管理系统都会实现从swagger服务自动同步的功能，即访问swagger服务的doc.json文件，将内容同步到自己系统里，即定期访问。然后创建示例项目，假如项目名称为go-project-name，创建main.go文件（先只定义包名即可），main.go内容如下。三方工具请求swagger服务，定期将文档同步到自己系统里面展示。启动一个swagger服务来展示；

[Go] Swaggo安装超时的解决

CnPeng

01-21

1274

1 问题现象在 GOPATH 目录中通过 go get -u github.com/swaggo/swag/cmd/swag 安装 swag 时可能会遇见连接超时的错误信息，导致安装失败，如下： package golang.org/x/text/unicode/bidi: unrecognized import path "golang.org/x/text/unicode/bidi" (https fetch: Get https://golang.org/x/text/unicode/bidi?g

Swagger新写的模块在页面不显示以及点击接口展开卡死问题

qq_45927587的博客

09-06

1129

Swagger找不到新写的模块和Swagger页面卡死

go使用报错：swag : 无法将“swag”项识别为 cmdlet、函数、脚本文件或可运行程序的名称

weixin_52658189的博客

03-22

2775

这时候才想起之前为了部署go项目，把环境改成了Linux，再把环境改回来windows就可以了。后来网上查找解决办法是去gopath 的bin目录下看一下有没有swag.exe文件。检查go.mod发现swagger已经下载下来了。##go使用swagger的坑。发现确实没有swag.exe。在执行这两句命令之后。

golang swagger

08-30

Golang Swagger是一种用于创建和管理API文档的工具。通过使用Swagger，我们可以自动化生成API文档，以便开发人员和用户可以更轻松地了解和使用API。在Golang项目中使用Swagger可以帮助我们定义API的路由和参数，并生成与之对应的文档。它可以通过SwaggerUI进行可视化展示，使得API的使用更加直观和便捷。要在Golang项目中使用Swagger，首先需要安装Go对应的Swagger相关的库。通过使用命令"go get"来安装这些库，如下所示： ``` $ go get -u github.com/swaggo/swag/cmd/swag $ go get -u github.com/swaggo/gin-swagger $ go get -u github.com/swaggo/files $ go get -u github.com/alecthomas/template ``` 安装完这些库之后，我们可以在项目根目录下执行"swag init"命令，用于初始化Swagger相关的配置和文档。接着，我们重新启动服务端，并访问Swagger的地址"http://127.0.0.1:8000/swagger/index.html"，就可以看到生成的Swagger文档。这个文档主要分为三个部分：项目主体信息、接口路由信息和模型信息，它们共同组成了API文档的主要内容。如果你想更深入地了解Golang Swagger的使用，可以参考官方文档提供的详细使用指南。同时，也可以参考示例存储库"golang-swaggerui-example"来学习如何在Golang项目中设置SwaggerUI并编写API文档。总结起来，Golang Swagger是一种用于创建和管理API文档的工具，通过它我们可以方便地定义和生成API文档，并通过SwaggerUI进行可视化展示。123 #### 引用[.reference_title] - *1* *3* [基于golang的swagger超贴心、超详细使用指南【有很多坑】](https://blog.csdn.net/asdfadafd/article/details/126081054)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] - *2* [golang-swaggerui-example:Golang的SwaggerUI生成示例](https://download.csdn.net/download/weixin_42139871/18681893)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]

“相关推荐”对你有帮助么？

非常没帮助
没帮助
一般
有帮助
非常有帮助

提交