protoc-gen-swagger配置

`protoc-gen-swagger` 是一个用于 Google Protocol Buffers (protobuf) 的插件，它生成了符合 Swagger（一种常用的应用程序接口描述语言）规范的 JSON 和 YAML 文件。当你使用 Protobuf 定义 API 服务的接口并编译时，这个插件会将这些接口转换为易于理解和使用的Swagger文档，这对于API的设计、文档化以及与其他工具和服务集成非常有帮助。

配置 `protoc-gen-swagger` 通常涉及以下几个步骤：

1. **安装**：首先，你需要在你的项目中安装 `protoc-gen-swagger`。如果你使用的是 Go 语言编写的插件，可以使用 `go get` 或者从 GitHub 上下载源码编译。

2. **添加插件到protoc命令**：在你的 `.proto` 文件所在的目录下运行 `protoc`，需要指定 `protoc-gen-swagger` 的路径。例如：

   protoc -I=$SRC_DIR --swagger_out=markdown:$DOC_DIR your_file.proto

这里 `$SRC_DIR` 是包含 `.proto` 文件的目录，`$DOC_DIR` 是你想输出 Swagger 文档的目录。

3. **配置选项**：你可以通过 `--swagger_opt` 参数传递额外的配置选项，如标题、版本等，例如：

   protoc -I=$SRC_DIR --swagger_out=markdown:$DOC_DIR \
         --swagger_opt=json=true \
         --swagger_opt=apiVersion=1.0.0 \
         your_file.proto

4. **验证生成的文档**：生成后，你可以打开 Swagger JSON/YAML 文件，使用在线工具如 Swagger UI 或其他支持Swagger的客户端检查是否符合预期。