Swagger Core <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/c3a8e639-625b-4020-ad6f-63ce89d82ab4.png" height="50" align="right">
注意： 如果你正在寻找 Swagger Core 1.5.X 和 OpenAPI 2.0，请参考 1.5 分支。
注意： 自 2.1.7 版本起，Swagger Core 也支持 Jakarta 命名空间。有一组带有 -jakarta 后缀的并行构件，提供与无后缀（即：javax）构件相同的功能。
详情请参阅 Wiki。
注意： 自 2.2.0 版本起，Swagger Core 支持 OpenAPI 3.1；详情请参阅此页面
Swagger Core 是 OpenAPI 规范的 Java 实现。当前版本支持 JAX-RS2（javax 和 jakarta 命名空间）。
开始使用 Swagger Core！
查看Swagger Core 入门指南，了解如何开始将 Swagger 添加到你的 API 中。
查看 Wiki！
GitHub wiki 包含文档、示例、贡献等内容。从那里开始吧。
兼容性
OpenAPI 规范自 2010 年首次创建以来经历了多次修订。Swagger Core 项目与 OpenAPI 规范有以下兼容性：
| Swagger 核心版本 | 发布日期 | OpenAPI 规范兼容性 | 备注 | 状态 |
|---|---|---|---|---|
| 2.2.22 (当前稳定版) | 2024-05-15 | 3.x | 标签 v2.2.22 | 支持中 |
| 2.2.21 | 2024-03-20 | 3.x | 标签 v2.2.21 | 支持中 |
| 2.2.20 | 2023-12-19 | 3.x | 标签 v2.2.20 | 支持中 |
| 2.2.19 | 2023-11-10 | 3.x | 标签 v2.2.19 | 支持中 |
| 2.2.18 | 2023-10-25 | 3.x | 标签 v2.2.18 | 支持中 |
| 2.2.17 | 2023-10-12 | 3.x | 标签 v2.2.17 | 支持中 |
| 2.2.16 | 2023-09-18 | 3.x | 标签 v2.2.16 | 支持中 |
| 2.2.15 | 2023-07-08 | 3.x | 标签 v2.2.15 | 支持中 |
| 2.2.14 | 2023-06-26 | 3.x | 标签 v2.2.14 | 支持中 |
| 2.2.13 | 2023-06-24 | 3.x | 标签 v2.2.13 | 支持中 |
| 2.2.12 | 2023-06-13 | 3.x | 标签 v2.2.12 | 支持中 |
| 2.2.11 | 2023-06-01 | 3.x | 标签 v2.2.11 | 支持中 |
| 2.2.10 | 2023-05-15 | 3.x | 标签 v2.2.10 | 支持中 |
| 2.2.9 | 2023-03-20 | 3.x | 标签 v2.2.9 | 支持中 |
| 2.2.8 | 2023-01-06 | 3.x | 标签 v2.2.8 | 支持中 |
| 2.2.7 | 2022-11-15 | 3.0 | 标签 v2.2.7 | 支持中 |
| 2.2.6 | 2022-11-02 | 3.0 | 标签 v2.2.6 | 支持中 |
| 2.2.5 | 2022-11-02 | 3.0 | 标签 v2.2.5 | 支持中 |
| 2.2.4 | 2022-10-16 | 3.0 | 标签 v2.2.4 | 支持中 |
| 2.2.3 | 2022-09-27 | 3.0 | 标签 v2.2.3 | 支持中 |
| 2.2.2 | 2022-07-20 | 3.0 | 标签 v2.2.2 | 支持中 |
| 2.2.1 | 2022-06-15 | 3.0 | 标签 v2.2.1 | 支持中 |
| 2.2.0 | 2022-04-04 | 3.0 | 标签 v2.2.0 | 支持中 |
| 2.1.13 | 2022-02-07 | 3.0 | 标签 v2.1.13 | 支持中 |
| 2.1.12 | 2021-12-23 | 3.0 | 标签 v2.1.12 | 支持 |
| 2.1.11 | 2021-09-29 | 3.0 | 标签 v2.1.11 | 支持 |
| 2.1.10 | 2021-06-28 | 3.0 | 标签 v2.1.10 | 支持 |
| 2.1.9 | 2021-04-20 | 3.0 | 标签 v2.1.9 | 支持 |
| 2.1.8 | 2021-04-18 | 3.0 | 标签 v2.1.8 | 支持 |
| 2.1.7 | 2021-02-18 | 3.0 | 标签 v2.1.7 | 支持 |
| 2.1.6 | 2020-12-04 | 3.0 | 标签 v2.1.6 | 支持 |
| 2.1.5 | 2020-10-01 | 3.0 | 标签 v2.1.5 | 支持 |
| 2.1.4 | 2020-07-24 | 3.0 | 标签 v2.1.4 | 支持 |
| 2.1.3 | 2020-06-27 | 3.0 | 标签 v2.1.3 | 支持 |
| 2.1.2 | 2020-04-01 | 3.0 | 标签 v2.1.2 | 支持 |
| 2.1.1 | 2020-01-02 | 3.0 | 标签 v2.1.1 | 支持 |
| 2.1.0 | 2019-11-16 | 3.0 | 标签 v2.1.0 | 支持 |
| 2.0.10 | 2019-10-11 | 3.0 | 标签 v2.0.10 | 支持 |
| 2.0.9 | 2019-08-22 | 3.0 | 标签 v2.0.9 | 支持 |
| 2.0.8 | 2019-04-24 | 3.0 | 标签 v2.0.8 | 支持 |
| 2.0.7 | 2019-02-18 | 3.0 | 标签 v2.0.7 | 支持 |
| 2.0.6 | 2018-11-27 | 3.0 | 标签 v2.0.6 | 支持 |
| 2.0.5 | 2018-09-19 | 3.0 | 标签 v2.0.5 | 支持 |
| 2.0.4 | 2018-09-05 | 3.0 | 标签 v2.0.4 | 支持 |
| 2.0.3 | 2018-08-09 | 3.0 | 标签 v2.0.3 | 支持 |
| 1.6.14 (当前稳定版) | 2024-03-19 | 2.0 | 标签 v1.6.14 | 支持 |
| 1.6.13 | 2024-01-26 | 2.0 | 标签 v1.6.13 | 支持 |
| 1.6.12 | 2023-10-14 | 2.0 | 标签 v1.6.12 | 支持 |
| 1.6.11版本 | 发布日期：2023-05-15 | OpenAPI规范版本：2.0 | 标签v1.6.11 | 支持中 |
| 1.6.10版本 | 发布日期：2023-03-21 | OpenAPI规范版本：2.0 | 标签v1.6.10 | 支持中 |
| 1.6.9版本 | 发布日期：2022-11-15 | OpenAPI规范版本：2.0 | 标签v1.6.9 | 支持中 |
| 1.6.8版本 | 发布日期：2022-10-16 | OpenAPI规范版本：2.0 | 标签v1.6.8 | 支持中 |
| 1.6.7版本 | 发布日期：2022-09-27 | OpenAPI规范版本：2.0 | 标签v1.6.7 | 支持中 |
| 1.6.6版本 | 发布日期：2022-04-04 | OpenAPI规范版本：2.0 | 标签v1.6.6 | 支持中 |
| 1.6.5版本 | 发布日期：2022-02-07 | OpenAPI规范版本：2.0 | 标签v1.6.5 | 支持中 |
| 1.6.4版本 | 发布日期：2021-12-23 | OpenAPI规范版本：2.0 | 标签v1.6.4 | 支持中 |
| 1.6.3版本 | 发布日期：2021-09-29 | OpenAPI规范版本：2.0 | 标签v1.6.3 | 支持中 |
| 1.6.2版本 | 发布日期：2020-07-01 | OpenAPI规范版本：2.0 | 标签v1.6.2 | 支持中 |
| 1.6.1版本 | 发布日期：2020-04-01 | OpenAPI规范版本：2.0 | 标签v1.6.1 | 支持中 |
| 1.6.0版本 | 发布日期：2019-11-16 | OpenAPI规范版本：2.0 | 标签v1.6.0 | 支持中 |
| 1.5.24版本 | 发布日期：2019-10-11 | OpenAPI规范版本：2.0 | 标签v1.5.24 | 支持中 |
| 1.5.23版本 | 发布日期：2019-08-22 | OpenAPI规范版本：2.0 | 标签v1.5.23 | 支持中 |
| 1.5.22版本 | 发布日期：2019-02-18 | OpenAPI规范版本：2.0 | 标签v1.5.22 | 支持中 |
| 1.5.21版本 | 发布日期：2018-08-09 | OpenAPI规范版本：2.0 | 标签v1.5.21 | 支持中 |
| 1.5.20版本 | 发布日期：2018-05-23 | OpenAPI规范版本：2.0 | 标签v1.5.20 | 支持中 |
| 2.0.2版本 | 发布日期：2018-05-23 | OpenAPI规范版本：3.0 | 标签v2.0.2 | 支持中 |
| 2.0.1版本 | 发布日期：2018-04-16 | OpenAPI规范版本：3.0 | 标签v2.0.1 | 支持中 |
| 1.5.19版本 | 发布日期：2018-04-16 | OpenAPI规范版本：2.0 | 标签v1.5.19 | 支持中 |
| 2.0.0版本 | 发布日期：2018-03-20 | OpenAPI规范版本：3.0 | 标签v2.0.0 | 支持中 |
| 2.0.0-rc4版本 | 发布日期：2018-01-22 | OpenAPI规范版本：3.0 | 标签v2.0.0-rc4 | 支持中 |
| 2.0.0-rc3版本 | 发布日期：2017-11-21 | OpenAPI规范版本：3.0 | 标签v2.0.0-rc3 | 支持中 |
| 2.0.0-rc2版本 | 发布日期：2017-09-29 | OpenAPI规范版本：3.0 | 标签v2.0.0-rc2 | 支持中 |
| 2.0.0-rc1 | 2017-08-17 | 3.0 | 标签 v2.0.0-rc1 | 支持中 |
| 1.5.18 | 2018-01-22 | 2.0 | 标签 v1.5.18 | 支持中 |
| 1.5.17 | 2017-11-21 | 2.0 | 标签 v1.5.17 | 支持中 |
| 1.5.16 | 2017-07-15 | 2.0 | 标签 v1.5.16 | 支持中 |
| 1.3.12 | 2014-12-23 | 1.2 | 标签 v1.3.12 | 支持中 |
| 1.2.4 | 2013-06-19 | 1.1 | 标签 swagger-project_2.10.0-1.2.4 | 已弃用 |
| 1.0.0 | 2011-10-16 | 1.0 | 标签 v1.0 | 已弃用 |
变更历史
如果您对 Swagger 和 Swagger Core 框架的变更历史感兴趣，请点击这里查看。
前提条件
您需要在您的 $PATH 中安装并可用以下内容：
- Java 11
- Apache maven 3.0.4 或更高版本
- Jackson 2.4.5 或更高版本
从源代码构建（当前版本 2.2.23-SNAPSHOT）
# 首次本地构建
mvn -N
后续构建：
mvn install
这将构建所有模块。
当然，如果您不想在本地构建，可以从 Maven 中央仓库获取构件：
https://repo1.maven.org/maven2/io/swagger/core/
示例应用
示例已移至新的仓库，包含各种集成和配置。
安全联系方式
请通过发送电子邮件至 security@swagger.io 披露任何安全相关问题或漏洞，而不要使用公共问题追踪器。
编辑推荐精选
Trae
字节跳动发布的AI编程神器IDE
Trae是一种自适应的集成开发环境（IDE），通过自动化和多元协作改变开发流程。利用Trae，团队能够更快速、精确地编写和部署代码，从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能，是提升开发效率的理想工具。
问小白
全能AI智能助手，随时解答生活与工作的多样问题
问小白，由元石科技研发的AI智能助手，快速准确地解答各种生活和工作问题，包括但不限于搜索、规划和社交互动，帮助用户在日常生活中提高效率，轻松管理个人事务。
Transly
实时语音翻译/同声传译工具
Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手，它拥有超精准的音频识别翻译能力，几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球，无论你是留学生、商务人士、韩剧美剧爱好者，还是出国游玩、多国会议、跨国追星等等，都可以满足你所有需要同传的场景需求，线上线下通用，扫除语言障碍，让全世界的语言交流不再有国界。
讯飞智文
一键生成PPT和Word，让学习生活更轻松
讯飞智文是一个利用 AI 技术的项目，能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定，还是学生群体的职业生涯规划、实习避坑指南，亦或是活动策划、旅游攻略等内容，它都能提供支持，帮助用户精准表达，轻松呈现各种信息。
讯飞星火
深度推理能力全新升级，全面对标OpenAI o1
科大讯飞的星火大模型，支持语言理解、知识问答和文本创作等多功能，适用于多种文件和业务场景，提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台，涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能，能为不同需求的用户提供便捷高效的帮助，助力用户轻松获取信息、解决问题，满足多样化使用场景。
Spark-TTS
一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型
Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目，由多个知名机构联合参与。该项目提供了高效的 LLM（大语言模型）驱动的语音合成方案，支持语音克隆和语音创建功能，可通过命令行界面（CLI）和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数，生成高质量的语音。该项目适用于多种场景，如有声读物制作、智能语音助手开发等。
咔片PPT
AI助力，做PPT更简单！
咔片是一款轻量化在线演示设计工具，借助 AI 技术，实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT，提供海量模板、智能美化、素材替换等功能，适用于销售、教师、学生等各类人群，能高效制作出高品质 PPT，满足不同场景演示需求。
讯飞绘文
选题、配图、成文，一站式创作，让内容运营更高效
讯飞绘文，一个AI集成平台，支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容，加速品牌传播，提升内容营销效果。
材料星
专业的AI公文写作平台，公文写作神器
AI 材料星，专业的 AI 公文写作辅助平台，为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能，支持 30 + 文稿类型生成，助力快速完成领导讲话、工作总结、述职报告等材料，提升办公效率，是体制打工人的得力写作神器。
openai-agents-python
OpenAI Agents SDK，助力开发者便捷使用 OpenAI 相关功能。
openai-agents-python 是 OpenAI 推出的一款强大 Python SDK，它为开发者提供了与 OpenAI 模型交互的高效工具，支持工具调用、结果处理、追踪等功能，涵盖多种应用场景，如研究助手、财务研究等，能显著提升开发效率，让开发者更轻松地利用 OpenAI 的技术优势。
推荐工具精选
AI云服务特惠
懂AI专属折扣关注微信公众号
最新AI工具、AI资讯
独家AI资源、AI项目落地
微信扫一扫关注公众号