大家好，我是铭毅天下。
最近升级 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 里
👉 老位置：
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
- 立刻更新书签
把 elastic.co/guide 换成 elastic.co/docs，别再用老链接了。
- 习惯新的找文档方式
不要先想"我要找 Elasticsearch 文档"，直接想"我要做搜索/可观测性/安全"。
- 关注内联版本标记
看文档时留意可用性徽章（标签），确认功能在你的版本里是否可用
- 老项目还用 8.X？
别慌，老文档还在 guide 路径，但建议结合自己业务需求规划升级。
unsetunset八、总结一句话unsetunset
Elastic 把文档从"产品手册"改成了"解决方案指南"，更贴近实战场景，熟练使用后会发现找东西更快了！
9.X 不仅代码升级，文档体验也全面升级。适应新文档结构，能让你的开发效率翻倍！
你用过 9.X 的新文档了吗？体验如何？欢迎评论区交流！
关注铭毅天下，每天学点 Elasticsearch 干货！
【视频】系统学习 Elastic Stack 技术栈，请先看这一套视频（基础篇01-10）
【视频】系统学习 Elastic Stack 技术栈，请先看这一套视频（进阶篇11-17）
【视频】系统学习 Elastic Stack 技术栈，请先看这一套视频（实战篇18-21）
更短时间更快习得更多干货！
和全球超2000+ Elastic 爱好者一起精进！
elastic6.cn------ElasticStack进阶助手
抢先一步学习进阶干货！