GoSwagger中@Failure路由颜色异常,与Success同为绿色
GoSwagger @Failure 显示绿色的问题解答
这是GoSwagger UI的默认行为,并非你遗漏了配置。
原因说明:
- GoSwagger UI(浏览器端的文档界面)默认会将所有HTTP响应条目(包括
@Success和@Failure对应的状态码)统一显示为绿色,它的样式设计并没有按照状态码类型区分颜色。 - 而Visual Studio中
@Failure显示为橙色/红色,是编辑器自身的语法高亮规则,和Swagger UI的展示逻辑完全独立,两者没有关联。
自定义样式(可选):
如果希望Swagger UI里的@Failure状态码(4xx、5xx)显示为橙色/红色,你需要自定义Swagger UI的CSS样式,比如针对不同状态码的响应块添加颜色规则。这不属于GoSwagger的默认配置,需要额外修改前端样式文件。
你的注释代码:
// Register godoc // @Schemes // @Description Create a user // @Tags register // @Accept json // @Produce json // @Param RegisterInput body RegisterInput true "Params to create an account" // @Success 200 {object} RegisterInput "Params of the created user" // @Failure 400 {object} req.HTTPError // @Failure 404 {object} req.HTTPError // @Failure 500 {object} req.HTTPError // @Router /register [post]
显示对比截图:
- 浏览器显示效果:

- Visual Studio注释高亮效果:

内容的提问来源于stack exchange,提问作者Kaido
相关产品推荐
相关产品推荐

