Prhub

#23801 docs: update Python prerequisite to 3.10

原始 PR 作者 Kare0638 合并时间 2026-04-28 06:36 文件变更 4 提交数 2 评论 1 代码增减 +7 / -3

执行摘要

文档中 Python 版本要求更新至 3.10+

Issue #23782 指出安装文档仍建议 Python >= 3.9,但实际包依赖要求 Python >= 3.10,文档与代码不一致可能导致用户安装失败。

建议精读,虽然是简单变更,但体现了保持文档与代码同步的重要性,适合作为文档维护的参考案例。

讨论亮点

无实质性 review 讨论,仅由 Fridge003 直接批准。

实现拆解

  1. docs_new/docs/get-started/install.mdx 的安装方法列表前新增一个 <Note> 提示块,明确标注“Prerequisites: Python 3.10 or higher”。
  2. docs_new/docs/get-started/quickstart.mdx 中的 Python 版本从“3.9 or higher”改为“3.10 or higher”。
  3. docs_new/docs/developer_guide/bench_serving.mdx 中的 Python 版本从“3.8+”改为“3.10+”。
  4. 同步更新旧版文档 docs/developer_guide/bench_serving.md 中的版本要求,同样从“3.8+”改为“3.10+”。
文件 模块 状态 重要度
docs_new/docs/get-started/install.mdx 安装文档 modified 2.89
docs_new/docs/get-started/quickstart.mdx 快速入门 modified 2.14
docs_new/docs/developer_guide/bench_serving.mdx 开发者指南 modified 2.14
docs/developer_guide/bench_serving.md 开发者指南 modified 1.32

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

纯文档变更,无代码逻辑修改,无回归、性能或安全风险。唯一风险是文档与实际包要求未来再次脱节。

用户:安装前能正确了解 Python 版本要求,避免因版本过低导致错误。团队:维护成本极低。

关联 Issue

#23782 [Docs] Installation page should specify Python >= 3.10 requirement not Python >= 3.9

完整报告

参与讨论