已注释文件列表

• 仓库：sgl-project/sglang
• 学习分支：sglang-learn
• 源代码分支基线：main
• 参考版本：v0.5.9
• 更新日期：2026-03-26

已完成

源文件	镜像注释副本	用途
python/sglang/cli/main.py	sglang-learn-comment/python/sglang/cli/main.py	顶层 CLI 入口，负责子命令分发
python/sglang/cli/serve.py	sglang-learn-comment/python/sglang/cli/serve.py	sglang serve 的模型类型识别与服务路径分流
python/sglang/launch_server.py	sglang-learn-comment/python/sglang/launch_server.py	标准 LLM 服务最终启动分发器
python/sglang/srt/entrypoints/http_server.py	sglang-learn-comment/python/sglang/srt/entrypoints/http_server.py	/v1/chat/completions 的 HTTP 路由入口，已注释主链路相关位置
python/sglang/srt/entrypoints/openai/serving_chat.py	sglang-learn-comment/python/sglang/srt/entrypoints/openai/serving_chat.py	OpenAI chat 协议到 GenerateReqInput 的转换层，已注释主链路相关位置

学习文档

文档	用途
sglang-learn-docs/项目结构拆解分析.md	从 AI 生态定位、顶层目录、运行时主链路、核心组件四个角度拆解仓库
sglang-learn-docs/SGLang与Ollama实现差异总结.md	总结两者在 API 位置、进程模型、请求链路、调度目标上的实现差异
sglang-learn-docs/v1-chat-completions请求源码走读.md	走读 /v1/chat/completions 从 HTTP 路由到 scheduler 的源码主链路

当前理解主线

阶段	说明
CLI 总入口	sglang 先进入 python/sglang/cli/main.py
serve 分发	sglang serve 进入 python/sglang/cli/serve.py
参数构建	标准 LLM 路径会调用 sglang.srt.server_args.prepare_server_args()
服务落点	python/sglang/launch_server.py 再根据 encoder_only / grpc_mode / use_ray 选择实际入口

下一批建议文件

状态	文件	原因
待注释	python/sglang/srt/managers/tokenizer_manager.py	运行时接入层，负责 tokenize、发往 scheduler、等待结果
待注释	python/sglang/srt/managers/scheduler.py	把 tokenized request 转成 Req 并决定 prefill/decode 调度
待注释	python/sglang/srt/managers/io_struct.py	GenerateReqInput 等链路关键数据结构定义