大家好，我是铭毅天下。

最近升级 Elasticsearch 9.X，发现官方文档彻底改版了，变化不小！

今天花 3 分钟，给大家捋一捋核心变化。

unsetunset一、Elasticsearch 官方文档网址变了！别找错地方unsetunset

8.X 时代：

文档在 elastic.co/guide 

👉 示例：https://www.elastic.co/guide/en/elasticsearch/reference/8.19/ 

从 5.X、6.X、7.X、8.X 一路跟过来的读者们应该对下面的界面非常熟悉。参加过 Elastic 认证的同仁更是相当熟悉。

9.X 时代：

全部搬到 elastic.co/docs 

👉 新地址：https://www.elastic.co/docs/ 9.X 

如下图所示，大家发现变化不少。

划重点：

• 老版本（8.19 及以前）还在 guide 路径

• 新版本（9.0 起）必须去 docs 站点

• 我们个人的 Elastic 收藏夹该更新了！

---

unsetunset二、不再按版本分文档了unsetunset

以前咋样？ 8.0 一套文档、8.1 一套文档、8.2 又一套...每个版本独立维护。

现在咋样？ 一个 9.x 文档打天下！所有 9.0、9.1、9.2 的变化都在一份文档里。 

https://www.elastic.co/docs/get-started/howto-use-the-docs

怎么区分版本差异？ 文档里加了"可用性徽章（标签）"，哪个功能是 9.1 加的、哪个是 9.2 改的，一目了然。

好处：不用在多个版本文档间来回跳，看一份就够了！

unsetunset三、文档组织逻辑变了unsetunset

以前：按产品分

• Elasticsearch Guide（查这个）

• Kibana Guide（查那个）

• Logstash Guide（再查另一个）

  

• 👉 8.X 示例：https://www.elastic.co/guide/en/elasticsearch/reference/8.19/index.html 

  现在：按你要干啥分

• • 搭建搜索应用？→ Build powerful search and RAG applications

  • 做可观测性？→ Resolve problems with observability

  • 搞安全分析？→ Detect, investigate, and respond to threats

  • 管理数据？→ Manage your data throughout its lifecycle

    

• 👉 9.X 新结构：https://www.elastic.co/docs/ 

• • 说人话：不管你用什么产品，直接找你的业务场景就行。

unsetunset四、Release Notes 独立了unsetunset

8.X：

Release Notes 藏在 Installation and Upgrade Guide 里 

👉 老位置：

https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/8.19/new.html

9.X：

独立放在 elastic.co/docs/release-notes 

👉 新位置：

https://www.elastic.co/docs/release-notes/

现在 Elasticsearch、Kibana、Security、Observability 的发布说明都在一个地方，找起来方便多了。

unsetunset五、API 文档路径加版本号了unsetunset

8.X：

elastic.co/docs/api/doc/elasticsearch/operation/xxx 

👉 示例：https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-get

9.X：

elastic.co/docs/api/doc/elasticsearch/v9/operation/xxx 

👉 示例：https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-get

多了个 /v9/，以后不同大版本 API 能共存，不会混淆。

unsetunset六、新增了啥？unsetunset

1.客户端库导航 Java、Python、.Net 等客户端，ES|QL、KQL 等查询语言，都有单独入口

2.版本说明文档 专门写了篇"Versioning and availability"，解释版本控制和功能可用性

https://www.elastic.co/docs/get-started/versioning-availability

这个链接很重要，建议务必收藏。

unsetunset七、铭毅的建议unsetunset

1. 立刻更新书签

 把 elastic.co/guide 换成 elastic.co/docs，别再用老链接了。

1. 习惯新的找文档方式

 不要先想"我要找 Elasticsearch 文档"，直接想"我要做搜索/可观测性/安全"。

1. 关注内联版本标记

 看文档时留意可用性徽章（标签），确认功能在你的版本里是否可用

1. 老项目还用 8.X？

 别慌，老文档还在 guide 路径，但建议结合自己业务需求规划升级。

---

unsetunset八、总结一句话unsetunset

Elastic 把文档从"产品手册"改成了"解决方案指南"，更贴近实战场景，熟练使用后会发现找东西更快了！

9.X 不仅代码升级，文档体验也全面升级。适应新文档结构，能让你的开发效率翻倍！

---

你用过 9.X 的新文档了吗？体验如何？欢迎评论区交流！

关注铭毅天下，每天学点 Elasticsearch 干货！

【视频】系统学习 Elastic Stack 技术栈，请先看这一套视频（基础篇01-10）

【视频】系统学习 Elastic Stack 技术栈，请先看这一套视频（进阶篇11-17）

【视频】系统学习 Elastic Stack 技术栈，请先看这一套视频（实战篇18-21）

如何系统的学习 Elasticsearch ？

---

更短时间更快习得更多干货！

和全球超2000+ Elastic 爱好者一起精进！

elastic6.cn——ElasticStack进阶助手

抢先一步学习进阶干货！