7. 代码导读

代码导读#

代码导读部分不是把仓库一层层罗列出来,而是把顶层目录、关键子系统和测试样例映射到前面已经建立好的心智模型上。读者在这一部分应该得到的是“如果我要继续深入,应该去哪看”,而不是一份缺少上下文的目录说明书。

这一部分的阅读目标很明确:把“主链路源码在哪里”“公开 API 在哪里”“例子和测试用来验证什么”“哪些目录属于性能或扩展能力”这几个问题放回一张仓库地图里。只有这样,前面章节提到的 launch_server.pyentrypointsmanagersmem_cache 才不会停留在点状记忆。

代码导读之所以放在靠后的位置,而不是一开始就讲,是因为它依赖前面已经建立好的系统心智模型。只有先理解请求主线、运行时边界、调度与执行模型,回头看仓库目录时,你才知道哪些目录是主链路、哪些是支撑材料、哪些是扩展或验证路径。

本节包含什么#

本节第一章是 7.1 从仓库入口回到请求主线。这一章会把 README.mdpython/sglang/__init__.pypython/sglang/lang/api.pypython/sglang/launch_server.pypython/sglang/srt/* 的关系先串起来,再说明 docsexamplestestbenchmarksgl-kernelsgl-model-gateway 这些区域各自提供什么价值。

代码导读章节不会替代真正的源码阅读。它做的是更轻但更关键的工作:给你一条“从公开入口回到内部实现,再从内部实现走到示例和测试”的路径。只要这条路径清楚,后续无论你想追性能、追协议适配还是追扩展点,都更容易找到正确入口。

本节对应哪些代码路径#

这一节的主锚点不是单个函数,而是几组入口目录:README.mdpython/sglang/__init__.pypython/sglang/lang/api.pypython/sglang/launch_server.py,以及 python/sglang/srt/entrypoints/python/sglang/srt/managers/python/sglang/srt/model_executor/python/sglang/srt/mem_cache/python/sglang/srt/observability/。它们共同回答的是“仓库应该怎样读”;这样设计的原因,是为了把前文建立的抽象重新落回真实目录与文件路径。