Torna 1.35.6 & 2.1.20 发布，接口文档解决方案

Torna 1.35.6 与 2.1.20 版本正式发布了。这次更新主要针对几个细节做了优化，先简单列几个重点：

• 单值返回结果的展示逻辑做了调整，读起来更清晰了；
• 修复了接口名称为空时，对应 Tab 标签莫名消失的问题；
• 新增了一个实用功能：点击接口名称可以直接跳转到预览页面；
• 文档描述中的 Markdown 格式识别和渲染逻辑也做了改进，不再那么容易翻车。

关于 Torna

简单介绍一下，Torna 是一款专注于接口文档管理的工具，目标就是让团队协作搞文档这件事变得更顺滑。它支持多人协同编辑和维护，同时兼容多种文档来源，可以把所有接口文档统一归档、集中管控。

和传统的 Swagger 相比，Torna 在保留核心能力的基础上，做了不少实用性的扩展，把原生方案在易用性、扩展性和集成性上的短板补上了不少。下面这张图可以帮大家快速感知一下。

直击文档管理核心痛点

在实际工作中，你可能遇到过这些场景：

• 对 Swagger 自带的文档预览和调试界面不太满意；
• 挺反感那种侵入式的注解方式，比如 @Api、@ApiOperation 之类的；
• 更倾向于基于标准 Ja vadoc 注释自动生成文档，并且能在线调试；
• 需要把公司内部多个项目的接口文档统一管理起来；
• 希望给外部合作方开放指定项目文档的只读访问权限，又不想暴露太多；
• 想把项目中用到的字典、枚举这类公共数据结构集中维护，省得各写各的。

如果你正面临上面任意一条，那 Torna 很可能就是你需要的那把钥匙。

快速上手指南

推荐技术组合

smart-doc + Torna —— 构建全自动文档闭环体系

如果你是 Ja va 开发者，强烈推荐试试 smart-doc + Torna 这个组合。这套方案在全行业已经算是公认的高效实践了——smart-doc 零侵入地解析 Ja va 源码和 Ja vadoc，精准提取 API 元信息，然后自动同步到 Torna 这个企业级文档管理平台。

说白了，你只需要写代码注释，接口文档就能自动生成并实时推送到平台，预览、参数校验、在线调试一条龙全搞定。

推送的内容包括：接口标题 / 作者信息 / 路径参数 / 请求头 / 请求体参数 / 返回结构 / 字典映射表 / 公共错误码列表，基本覆盖了日常所需。

如果不是 Ja va 技术栈也不用担心，Torna 内置了可视化表单编辑器，可以手动录入上面这些字段，同样支持完整的预览和调试能力。

源码获取地址：立即下载