在最新版本中,支持“可视化结构”和“原生模式”2种模式,但是在可视化结构模式下填写的字段和说明,最终在发布的接口文档中,却没有把对应的字段说明带出来,这就很坑爹了,辛辛苦苦把字段说明写上去,居然没用。
我看过其他大佬的帖子,也看过官方的回复,说是:要在原生模式下,单击“提取字段和描述”,然后在输入对应字段的描述,既然这样,为什么还要多个可视化结构呢,完全没发挥其价值。我挺看好可视化结构这个功能的,因为可视化结构可以导入字段信息,而且可以通过编辑代码来快速调整顺序,建议把可视化结构和原始模式之间的功能要打通,2边的字段和描述可以相互导入。
另外,建议原生模式下可以调整字段顺序,以及可以导入和导出字段和描述信息,因为在接口文档有更新时,需要在某些字段中间加入新的字段,这就很麻烦了,又不能点击“提取字段和描述”,因为一点击,已经填写好的内容就会重置(虽然描述不会变,但是字段的数据类型就会重置,尤其是json值为null的时候,原本已经改好了,但是一重置就没了),那后果想想就觉得蛋疼。
当前版本:7.1.6
收到,我具体反馈一下。非常感谢您的建议