概览#

概览部分先不急着深入某个实现细节，而是先回答“这本书打算怎么讲”与“为什么 SGLang 值得这样讲”。如果一上来就掉进 python/sglang/srt 的细枝末节，读者很容易把整套系统误读成一组 runtime internals，而错过它作为 frontend language、runtime surface 与接口层的整体形态。

因此，概览部分承担两个任务。第一是锁定第一版范围，明确什么会讲、什么不讲。第二是建立最基础的心智模型：SGLang 不是只有一条 serving 路径，它对外暴露的 public surface 同时包括语言层 API、runtime endpoint，以及更常见的服务化入口。

这也是为什么全书必须从这里开场，而不是直接进入 request lifecycle 或 scheduler.py。概览的职责不是提供更多细节，而是先把“读者为什么要沿着这条顺序阅读”说清楚。只有这样，后文逐步下钻到 runtime、cache、execution model 时，读者才不会把每一章都误解成独立文章。

本节包含什么#

本节第一章是 1.1 第一版范围与阅读地图，它负责说明第一版的目标、非目标、推荐阅读顺序，以及各章节之间的依赖关系。读者读完这一章之后，应该知道为什么本书不会把全部实验特性或全部目录都拉进首发版本。

第二章是 1.2 为什么是 SGLang：Frontend Language 与 Runtime 心智模型。这一章的重点，不是解释每个 API 的参数，而是用上游 README、python/sglang/__init__.py 和公开文档入口来证明：SGLang 对外的形状，本来就不是“只有 server 的一个 runtime”。

本节对应哪些代码路径#

概览本身不是源码细节章，但它仍然需要给出稳定锚点。最重要的入口包括上游 README.md、python/sglang/__init__.py、python/sglang/lang/api.py 与 python/sglang/launch_server.py。前两者帮助我们确定项目如何向外介绍自己，后两者则帮助我们把 frontend language、runtime surface 与 service entrypoint 区分开。

因此，概览章节解决的问题是“读者为什么要按这条路径读”；这样设计的原因，是为了先建立系统级心智模型；对应的代码路径，则集中在这些对外入口文件，而不是一开始就深入 python/sglang/srt 内部。