其他
1.2K Stars 国产开源文档生成工具，零侵入！
每天给大家带来网站工具、开源社区项目、开源软件、安卓&IOS软件等黑科技！
如果你们有什么好的建议，也可以在后台留言。
创作不易，希望大家给一点鼓励，把公众号设置为"星标"，给文章点下"赞"和"在看"，谢谢大家！每日持续更新，望宝子们多多支持~
smart-doc 是一款同时支持 Java Rest Api 和 Apache Dubbo RPC 接口文档生成的工具，在业内率先提出基于 Java 泛型定义推导的理念，完全基于注释生成文档，做到零侵入。
🎨️ 最新版功能
零注解、零学习成本、只需要写标准JAVA注释。 基于源代码接口定义自动推导，强大的返回结构推导。 支持Spring MVC、Spring Boot、Spring Boot Web Flux(Controller书写方式)、Feign。 支持Callable、Future、CompletableFuture等异步接口返回的推导。 支持JavaBean上的JSR303参数校验规范，包括分组验证。 对JSON请求参数的接口能够自动生成模拟JSON参数。 对一些常用字段定义能够生成有效的模拟值。 支持生成JSON返回值示例。 支持从项目外部加载源代码来生成字段注释(包括标准规范发布的jar包)。 支持生成多种格式文档：Markdown、HTML5、Word、Asciidoctor、Postman Collection、OpenAPI 3.0。开放文档数据，可自由实现接入文档管理系统。 支持导出错误码和定义在代码中的各种字典码到接口文档。 支持生成Jmeter性能测试脚本。 支持Maven、Gradle插件式轻松集成。 支持Apache Dubbo RPC接口文档生成。 支持基于Git管理项目的变更增量文档生成。 debug接口调试html5页面完全支持文件上传，下载(@download tag标记下载方法)测试。
🧰 最佳实践方案
smart-doc + Torna 组成行业领先的文档生成和管理解决方案，使用smart-doc无侵入完成Java源代码分析和提取注释生成API文档， 自动将文档推送到 Torna 企业级接口文档管理平台。
Torna 是由 smart-doc 官方独家推动联合研发的企业级文档管理系统， 集成 torna 需要使用 smart-doc 2.0.9 版本及以上，目前也是主推 smart-doc+Torna 的这套方案。
如下图所示：
🍄smart-doc和swagger对比
🌱快速体验
环境版本：
Maven 3.3.9+
JDK1.8+
{ "outPath": "/path/to/userdir", // 接口文档输出地址 "serverUrl": "http://127.0.0.1:8080"// 请求路径}./src/main/resources/static/doc
<plugin> <groupId>com.ly.smart-doc</groupId> <artifactId>smart-doc-maven-plugin</artifactId> <version>[最新版本]</version> <configuration> <configFile>./src/main/resources/smart-doc.json</configFile> <projectName>${project.description}</projectName> <includes> <!-- 使用了mybatis-plus的Page分页需要include所使用的源码包 --> <include>com.baomidou:mybatis-plus-extension</include> <!-- 使用了mybatis-plus的IPage分页需要include mybatis-plus-core--> <include>com.baomidou:mybatis-plus-core</include> <!-- 使用了jpa的分页需要include所使用的源码包 --> <include>org.springframework.data:spring-data-commons</include> </includes> </configuration> <executions> <execution> <!--如果不需要在执行编译时启动smart-doc，则将phase注释掉--> <phase>compile</phase> <goals> <!--smart-doc提供了html、openapi、markdown等goal，可按需配置--> <goal>html</goal> </goals> </execution> </executions></plugin>3、在 IDEA 中直接使用 Maven 插件目录下的 smart-doc 模块
或者在命令行中执行
mvn -Dfile.encoding=UTF-8 smart-doc:htmlmvn -Dfile.encoding=UTF-8 smart-doc:markdownmvn -Dfile.encoding=UTF-8 smart-doc:torna-rest...4、文档效果演示：
相比较来说 smart-doc 以其最小的代码侵入性、与代码实时同步更新、前期工作量最低、可单独生成单独部署等优点，在众多文档工具中脱颖而出，目前很多大厂也都在使用，如小米、科大讯飞等，无论你是有经验的大佬、还是刚入行的萌新，都能轻松上手。有需要的宝子不要错过~
附项目的链接：
GitHub开源地址：
https://github.com/TongchengOpenSource/smart-docGitee开源地址：https://gitee.com/TongchengOpenSource/smart-doc
官方文档：
https://smart-doc-group.github.io/#/zh-cn官方demo:
https://gitee.com/smart-doc-team/smart-doc-example-cn仓库主页：
往期推荐：