torna 2.1.15 正式发布,本次版本更新如下:
- 改进模板配置逻辑与代码生成文档说明
- 提升文件夹识别的准确性与健壮性
- 修复 OpenAPI 3 导出时,当类型为 array 却缺失
items字段的问题
关于 Torna
一款专注于接口文档治理的开源解决方案,致力于让接口文档的编写、协作与维护更高效、更直观。Torna 以团队协作为核心,支持多格式文档接入,实现集中化、标准化的统一管理。
相较于传统工具(如 Swagger),Torna 在保留其核心能力的基础上,进一步拓展了实用性功能,有效弥补了其在企业级场景中的短板。

直击文档管理核心痛点
- 对 Swagger 默认预览页与调试界面的交互体验不满意
- 抵触在代码中大量添加侵入式注解(如
@ApiParam、@ApiOperation) - 倾向于仅通过标准 Javadoc 注释即可自动生成可调试文档
- 需要将全公司多个项目的接口文档整合至同一平台进行统筹管理
- 需要向外部合作方安全、可控地开放部分接口文档查阅权限
- 希望对项目中各类字典、枚举值进行结构化归档与统一维护
若您正面临上述任一挑战,Torna 或许正是您需要的文档协同平台。
快速上手指南
最佳实践组合
smart-doc + Torna —— 打造端到端文档自动化流水线
pui 是一款基于jQyery开发的插件库。目前线上稳定使用已有2年多,丰富的接口,简单明了的调用方式,灵活的回调函数,让您轻轻松松打造出富有灵活交互的Web前端界面解决方案。 插件库封装了布局、表单元素、表单校验、弹窗、toast、气泡pop、tab切换、日历时间、分页、表格、树、css命名等功能
Java 开发者强烈推荐采用 smart-doc + Torna 组合方案。
该组合已成为业界公认的高成熟度文档生态:smart-doc 无需修改业务代码,通过静态分析 Java 源码及 Javadoc 自动生成标准 API 文档,并实时同步至 Torna 企业级文档管理平台。
借助此方案,您只需专注编写清晰的 Java 注释,即可自动完成接口信息上传,进而实现在线预览、参数模拟、接口调试等完整闭环。
同步推送内容涵盖:接口标题/作者/路径参数/请求头/Header/请求体参数/响应结构/字典枚举列表/通用错误码
对于非 Java 技术栈用户,亦可通过平台内置表单页面手动录入上述全部字段,同样支持所见即所得的文档预览与在线调试功能。
源码下载地址:点击获取









