# PR #23801 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs: update Python prerequisite to 3.10
- 合并时间：2026-04-28 06:36
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/23801

---

# PR 分析报告：文档中 Python 版本要求更新至 3.10+

## 执行摘要

该 PR 根据 Issue #23782 和 `pyproject.toml` 中的实际依赖要求，将安装、快速入门和性能基准测试文档中过时的 Python 版本条件（3.8+/3.9+）统一更正为 3.10+，属于纯粹的文档同步变更。

## 功能与动机

Issue #23782 指出，安装页面上要求 Python >= 3.9，但 SGLang 主包 `python/pyproject.toml` 中实际定义的 `python_requires` 是 `>=3.10`。文档与代码不一致会导致用户按照文档指引安装而失败。本 PR 旨在消除这一歧义，确保文档准确反映包的最小 Python 版本。

## 实现拆解

1. **主安装页 (install.mdx)**：在安装方法列表之前插入一个 `<Note>` 组件，明确标注先决条件为“Python 3.10 or higher”，最直接地触达多数用户。
2. **快速入门 (quickstart.mdx)**：将 Prerequisites 中的 Python 版本从“3.9 or higher”改为“3.10 or higher”。
3. **新版性能测试文档 (bench_serving.mdx)**：将 Prerequisites 中的 Python 版本从“3.8+”改为“3.10+”。
4. **旧版性能测试文档 (bench_serving.md)**：同步更新，将“3.8+”改为“3.10+”，保持新旧两版文档一致性。

该 PR 仅修改文档文件，未涉及任何源代码、配置或测试。

### 无（纯文档变更）。

## 评论区精华

无实质性讨论，PR 由 Fridge003 直接批准。

## 风险与影响

- **风险**：无功能风险，唯一风险是未来 `pyproject.toml` 更改 Python 版本后文档未同步更新。
- **影响**：用户安装前能正确了解 Python 版本要求，避免因版本不满足导致安装失败；对现有运行中的服务无任何影响。

## 关联脉络

- 关联 Issue #23782 是直接的触发来源。
- 近期历史 PR 中无直接相关的文档同步变更，但体现了项目对文档质量的一贯关注（例如 PR #23851、#23845 等文档改进）。
- 该 PR 是项目持续维护文档准确性的体现，建议后续考虑在 CI 中加入文档版本检查，防止类似脱节再次发生。