第 2 章 试验场：搭建单节点并送出第一条文档
文档摘要
第 2 章 · 试验场：搭建单节点并送出第一条文档 章节摘要：概念地图再精确，也替代不了亲手跑一遍。本章用最短路径搭起一个单节点 Elasticsearch 加 Kibana 控制台，然后把 doc-1001 真正写进去、查出来、删掉再重建。这一趟往返会让你提前遇见后面所有章节的主角：索引、映射、文档 API、查询 DSL。环境刻意保持最小——学习阶段的每分精力都应该花在文档的旅程上，而不是和分布式搏斗。 学习目标 阅读完本章，你应当能够： 独立完成单节点 Elasticsearch 与 Kibana 的安装、启动与健康验证。 说出 REST 请求的四个组成部分：方法、路径、请求体、返回码，看懂一次响应的结构。 完成"建索引、写文档、查文档、删文档"的最小闭环，并复述每一步引擎里发生了什么。
第 2 章 · 试验场：搭建单节点并送出第一条文档
章节摘要：概念地图再精确，也替代不了亲手跑一遍。本章用最短路径搭起一个单节点 Elasticsearch 加 Kibana 控制台，然后把 doc-1001 真正写进去、查出来、删掉再重建。这一趟往返会让你提前遇见后面所有章节的主角：索引、映射、文档 API、查询 DSL。环境刻意保持最小——学习阶段的每分精力都应该花在文档的旅程上，而不是和分布式搏斗。
学习目标
阅读完本章，你应当能够：
- 独立完成单节点 Elasticsearch 与 Kibana 的安装、启动与健康验证。
- 说出 REST 请求的四个组成部分：方法、路径、请求体、返回码，看懂一次响应的结构。
- 完成"建索引、写文档、查文档、删文档"的最小闭环，并复述每一步引擎里发生了什么。
- 解释首次写入时动态映射的行为，知道为什么生产环境要关掉它。
- 用集群健康接口判断自己的一人集群处于什么状态。
核心概念速览
金句：环境最小化不是偷懒，是把认知负载集中到一条文档的往返上——引擎装得再大，旅程的每一步也是从一次 PUT 开始的。
子章节导航
2.1 搭建单节点集群与 Kibana 控制台
从下载包讲到改配置、起进程、看日志、验健康，再装上 Kibana 作为顺手的驾驶舱。一节的篇幅覆盖 Windows 与 Linux 两条路径，并给出内存与常见启动失败的处置。
2.2 第一条文档的往返：从写入到检索
亲手执行"建索引、写文档、按 id 取、按词搜、删文档"五个动作，每个动作配上引擎内部的解释。这一节是全书的微缩预演，第 3 到 5 章会分别把这五步拆开放大。
子章节之间的逻辑关系
两节是"台子"与"戏"的关系：先有能跑的环境，再让 doc-1001 登场走完一次完整往返。如果已有现成环境，可以直接跳到 2.2，但五步闭环建议亲手敲一遍——肌肉记忆比阅读记忆可靠得多。
2.1 装好台子（节点+控制台） ──► 2.2 doc-1001 登场（五步闭环） │ ├─► 第3章 第3步被放大：映射与分析器 ├─► 第4章 第2步被放大：写入与路由 └─► 第5章 第4步被放大：查询与打分
本章考核清单
| 考核点 | 达标标准 | 对应小节 |
|---|---|---|
| 独立搭建环境 | 从压缩包到健康接口返回绿色（或解释为何黄色），全程不看资料 | 2.1 |
| 读健康响应 | 说出 status、number_of_nodes、active_shards 三个字段的含义 | 2.1 |
| 五步闭环 | 独立完成建索引、写、取、搜、删，并复述每步引擎内发生了什么 | 2.2 |
| 解释动态映射 | 说出首次写入时 title 被推断成的类型，以及生产关闭动态推断的理由 | 2.2 |
| 解释写入后搜不到 | 用"缓冲区到段的刷新间隔"回答，并给出两种立即可见的办法 | 2.2 |
易错点速查
- 堆内存照抄网上的大数值：学习机 1GB 足够，堆过大反而挤占 Lucene 依赖的文件系统缓存，启动失败多半先查这里。
- 环境一坏就重装：九成的"环境坏了"是数据目录残留旧状态，清空 data 目录比重装快得多。
- 跳过控制台用图形向导建索引：先把请求亲手写熟，看得见每一步的学习收益比效率更重要。
- 版本配套被忽略：节点与控制台主版本要一致，跨大版本升级永远成对进行，先读版本说明再动手。
前置知识与后续延伸
- 前置知识：第 1 章的概念地图（尤其分片与索引的关系）；会发 HTTP 请求的任意工具（系统自带命令行即可，Kibana 控制台更佳）；机器上有 2GB 空闲内存与 1GB 磁盘。
- 后续延伸：本章的动态映射在 3.1 被显式映射取代；一次一条的写入在 4.3 变成批量流水线；match 查询在 5.2 长成完整的布尔组合；黄色状态之谜在 8.1 的健康检查里彻底解开。