Golang项目中如何在Swagger-UI排除特定版本标签（如v1）

你的自定义插件无效，大概率是因为tagDetails selector并非修改标签显示的正确切入点——这个selector仅控制标签列表的渲染，但Swagger UI会从原始OpenAPI规范中读取标签用于多处展示，且新版Swagger UI的状态结构或selector命名可能已发生变化。

以下是几种可靠的解决方法：

方法1：从源头修改OpenAPI规范（推荐） #

如果可以控制swagger.json的生成流程，直接在规范中移除不需要的标签是最彻底的方案：

• 在Golang项目中，若使用swag工具生成规范，可通过自定义模板或后处理脚本，过滤掉tags数组中的v1项；
• 手动处理swagger.json：
  1. 删除tags数组里name为v1的对象；
  2. 遍历所有paths下的接口操作，移除tags数组中的v1值。

方法2：使用Swagger UI的modifySpec插件钩子 #

通过插件修改加载后的OpenAPI规范，让整个UI基于过滤后的内容渲染，代码如下：

const TagFilterPlugin = () => {
  return {
    modifySpec: (spec) => {
      // 过滤全局标签列表
      if (spec.tags) {
        spec.tags = spec.tags.filter(tag => tag.name !== 'v1');
      }
      // 过滤每个接口操作上的标签
      if (spec.paths) {
        Object.values(spec.paths).forEach(pathItem => {
          Object.values(pathItem).forEach(operation => {
            if (operation?.tags) {
              operation.tags = operation.tags.filter(tag => tag !== 'v1');
            }
          });
        });
      }
      return spec;
    }
  };
};

SwaggerUI({
  url: "swagger.json",
  dom_id: '#swagger-ui',
  plugins: [
    SwaggerUI.plugins.DownloadUrl,
    TagFilterPlugin
  ]
});

这个方法直接修改了Swagger UI加载的规范数据，所有依赖标签的UI组件都会同步生效，比仅拦截selector更可靠。

方法3：CSS hack（仅临时应急） #

如果上述方法无法快速实现，可通过CSS强制隐藏v1标签，缺点是Swagger UI结构更新后可能失效：

/* 隐藏标签列表中的v1标签 */
.swagger-ui .tag-group:has(.tag-name:contains("v1")) {
  display: none !important;
}
/* 隐藏接口卡片上的v1标签 */
.swagger-ui .op-tag:contains("v1") {
  display: none !important;
}

注意：部分浏览器可能需要开启:has选择器的支持。

内容的提问来源于stack exchange，提问作者Chirag Makwana