阅读地图：把知识用到一个完整项目里

从哪里开始

这里的内容分成六类。知识库解释原理；Dev Guide 提供语言和工具的系统查阅；开发实践讨论具体问题；算法记录解题方法；项目把多个知识点连成实现；博客承载整理方法与思考。遇到一个问题时，先找原理，再看实现，最后用测试确认理解。

如果是第一次阅读，可以先看 Vibe Coding 与全栈开发。已有开发经验时，直接选择下面的一条路线，不必从第一章逐篇读完。

想把分散知识连接成一个能上线的功能，可以先看 从一个功能到生产：全栈交付路线，再按文中链接深入每一层。

搜到同名主题时怎样选择

部分主题会同时出现在知识库、Dev Guide 和开发实践中，这是三个不同阅读层次：

例如搜索“分布式系统”时，先读知识库建立一致性、可用性和故障模型，再到 Java Guide 查具体生态；遇到数据重复、超时或锁问题时，进入开发实践看失败时序。后续审校会逐步在同名标题中补上层次标记和互链。

路线一：完成一个前后端交互功能

练习目标：做一个任务列表，支持新增、查询和更新状态。先在本地完成，不急于加入缓存或微服务。

完成标志：从页面创建的数据，刷新后仍可查询；无效输入有明确反馈；至少一个失败路径可重复验证。

路线二：把“能运行”推进到“能维护”

沿用上面的任务列表，围绕已经遇到的问题补工程能力。

1. 读 测试策略，为创建、更新与无效输入建立可重复检查。
2. 读 异常处理实践，约定对用户的提示与排错信息。
3. 读 系统可观测性实践，从一次失败请求找到对应记录。
4. 读 索引优化实践，记录查询条件和执行计划，再比较改动前后结果。
5. 读 技术选型，写下一个暂时不引入新组件的决定及理由。

完成标志：别人能按说明启动项目、复现一个问题并验证修复；性能结论附有数据量、测试条件和测量结果。

路线三：通过本站学习静态内容系统

1. 阅读 本站项目说明，理解内容扫描、页面生成与预览之间的关系。
2. 新建一篇短文章，加入标题、表格、代码和另一篇文章的相对链接。
3. 运行构建，从首页找到文章，再用正文末尾的独特词语搜索它。
4. 对照 技术写作，检查文章是否回答了一个明确问题。
5. 按 知识整理方法 给文章补上前置知识、验证步骤与后续阅读。

完成标志：文章能通过导航和搜索到达，链接可点击，示例能验证，阅读后知道下一步做什么。

每次学习留下什么

不用再写一篇所有知识点的汇总。保留四样东西即可：一个明确问题、一个最小示例、一条验证结果、一个仍未解决的边界。相同原理链接回已有文章，具体场景留在实践或项目里。

内容还需要怎样完善

目前应优先补齐跨文章关联、示例的适用条件和可复现步骤。现有技术文章仍需逐篇核验版本与结论；“有文章”不代表已经完成技术审校。算法内容可以逐步按题型建立索引；项目内容应以实际代码与结果为依据，再增加独立案例。

可运行实验

完成工程路线后，运行 幂等、缓存与过期锁实验，用失败时序检查自己的理解；本站维护可对照 Markdown 验收页。