一个想法：通过中间层代理来解析 API 输入/输出，自动生成 swagger 文档

[page470075640]

代理目标是 API test code ，想知道有现成的这类工具吗？如果没有我就打算尝试一下。。。

[jstony]

感觉意义不大，一般不是应该文档先行吗？

[luvroot]

grpc reflect 现在就支持

[xaplux]

接口描述，参数描述等获取不到吧，感觉这个还是比较重要的

[page470075640]

@jstony 不同的开发方式吧。。。我这边都是写完测试代码后才开始写文档的

@luvroot 能贴一下项目链接吗？

@xaplux 参数描述确实是个问题，目前的想法是通过变量的语义和错误信息来说明这个问题。

[luvroot]

@page470075640 https://pkg.go.dev/google.golang.org/protobuf/reflect/protoreflect 其他语言的应该也有对应的实现

[wdwwtzy]

不太明白，写注释的时候，不就是写好了 swagger 文档吗？是其他语言不行吗？.net 就是注释就是 swagger 文档

[luvroot]

一般都是通过写注释写好了 由工具生成 swagger json 。
还有一种完全不写注释，比如 grpc 的这种通过 reflect 找到接口名字和参数，只提供接口名和参数展示

[page470075640]

结贴：通过注释或者 grpc 能自动生成 swagger ，谢谢各位答疑解惑

[kkeep]

已经有了

[ternice]

swagger 感觉只适合 个人开发或者独立开发
实际项目 接口设计和接口实现就不是一个人，都是先有文档才有接口