前言

这本书怎么查

这不是从头读到尾的书。全书八个部分、32 章：第 1–30 章各讲一个工具或一类工具，第 31 章按症状排障，第 32 章（第八部分）按方向列学习资源；书后有附录 A 到 E。按你手里有什么找入口：

你手里有什么	翻哪里
一个工具名	按工具翻目录，直接进对应章
一个任务	附录 A“按任务反查”，按任务找到该用的工具和命令
一条报错	第 31 章“排障工具箱”和各章的“注意事项”
一个快捷键	附录 B“快捷键总表”，VS Code、终端、浏览器开发者工具各一张表
一个端口或配置文件	附录 C“默认端口与配置文件路径”
一个不认识的术语	附录 E“术语表”，查到英文名和首次出现的小节
想看某个工具的官方文档	附录 D“深入阅读总表”，各章“深入阅读”的网址都在这里
想把一个方向学扎实	第八部分，第 32 章“按方向的可用资源”

“注意事项”每条最前面是症状，也就是你在屏幕上看到的报错或现象。拿着报错原文去搜，就能找到。

第 1–30 章每章都有七个固定小节，位置不变（第 31、32 章按症状和方向分节，不用这个格式）：

小节	内容
N.1 安装与版本	三个平台各一条安装命令，加查版本的命令；服务类工具是一行 docker compose
N.2 五分钟概念	三到六个概念，不懂它们就看不懂后面的命令
N.3 常用命令	全章主体，按任务分组的表，要查命令先翻这里（VS Code 和浏览器开发者工具章叫「常用操作与快捷键」，扩展章叫「常用扩展」）
N.4 典型工作流	两三条从头做到尾的步骤，每步一条命令
N.5 配置要点	配置文件在哪，哪几项值得改，附最小配置
N.6 注意事项	每条按“症状、原因、处理”写
N.7 深入阅读	官方文档和长期维护站点的网址

本书覆盖 Linux、macOS 和 Windows。

命令块标 bash 的，在 Linux、macOS 和 Windows 的 PowerShell 7 里都能用。
只有 PowerShell 写法不同的，另给一块标 powershell。
快捷键表给 Windows 和 macOS 两列。Linux 与 Windows 相同，不另列。
Windows 命令假定你装了 PowerShell 7 和 Windows Terminal。PowerShell 7 的安装命令是 winget install Microsoft.PowerShell。
命令里的 <尖括号> 是要你替换的部分。比如 git clone <url>，要把 <url> 换成真实地址，连尖括号一起去掉。

数据库、缓存、队列、Web 服务器，本书全部用 Docker 跑，不写它们的本机安装。这样三个平台的步骤一致，删起来也干净。

先从 Docker Desktop 下载页安装 Docker Desktop，再照附录 C 末尾“随书 compose 文件全文”建好 compose/ 目录，然后在这个目录下运行：

docker compose --profile <组> up -d

组名和服务对应如下：

几点说明：

PostgreSQL（用户 postgres）和 MySQL（用户 root）的口令是 dev；Redis、MongoDB、Kafka 不设口令；RabbitMQ 管理界面用 guest/guest。这些口令只给本机练习用，不要用到别处。
数据放在命名卷（named volume）里，docker compose --profile all down 不会删。
docker compose --profile all down -v 会连卷一起删，数据全部丢失。

端口被本机已有的服务占用时，会看到：

Bind for 127.0.0.1:3306 failed: port is already allocated

处理有两个办法：停掉本机占用该端口的服务；或者把 compose 文件里端口映射左边的宿主机端口改掉，比如 "127.0.0.1:3306:3306" 改成 "127.0.0.1:3307:3306"，之后连 3307。

第 1–31 章题记第三行写着作者核对该章命令时用的版本和年月，例如 核对版本：Redis 8，2026-10。第 32 章列的是网址，写的是核对日期。

工具更新后，个别命令可能变化。遇到对不上的，以官方文档为准。第 1–31 章末尾的“深入阅读”都给了网址。

只收官方文档和长期维护的站点。

带“国内镜像”的，是中文版或镜像站。它们的内容可能比官方滞后，版本以官方为准。

随书 compose 的四个文件不另提供下载，全文印在附录 C 末尾“随书 compose 文件全文”，照那里的目录结构复制保存即可。