• 请不要在回答技术问题时复制粘贴 AI 生成的内容
smartdoc647
V2EX  ›  程序员

smart-doc 3.1.1 发布, Java 零注解 API 文档生成工具

  •  
  •   smartdoc647 · Jun 30, 2025 · 1709 views
    This topic created in 319 days ago, the information mentioned may be changed or developed.

    smart-doc 是一款同时支持 JAVA REST API 和 Apache Dubbo RPC 接口文档生成的工具,smart-doc 利用接口泛型和 javadoc 注释自动分析生成 api 接口文档,不采用任何注解侵入到业务代码中。只需要在项目中引入 smart-doc 提供的 maven 或者是 gradle 插件,然后按照规范写好 javadoc 注释即可生成 api 文档。同时 smart-doc 也支持生成 openapi 和 postman 这些规范的文档,生成后可以直接导入相关工具做测试。

    目前在国内已被小米、科大讯飞、同程旅行、快手、马蜂窝、顺丰等知名公司所使用。

    仓库地址

    https://github.com/TongchengOpenSource/smart-doc

    重要更新内容

    修复 map 类型 key 的类型检查错误。 修复 response 字段使用 @JsonProperty(access = JsonProperty.Access.READ_ONLY)时文档生成错误的 修复 openapi 生成上的多个 bug

    未来计划

    AI 虽然聪明,但是当前 smart-doc 服务的领域无论是在生成速度和准确度都远超 AI, 未来我们会持续更新支持 idea 插件

    1 replies    2025-06-30 18:18:18 +08:00
    pisay
        1
    pisay  
       Jun 30, 2025
    加油,用了很多年了 希望越来越好!
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   5155 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 41ms · UTC 09:42 · PVG 17:42 · LAX 02:42 · JFK 05:42
    ♥ Do have faith in what you're doing.