You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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]

显示对比截图:

  • 浏览器显示效果:
    浏览器中Swagger UI的显示
  • Visual Studio注释高亮效果:
    Visual Studio中的注释高亮

内容的提问来源于stack exchange,提问作者Kaido

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.12 05:38:10