Prhub

#29676 [Docs] Add --prerelease=allow so uv installs the latest sglang

原始 PR 作者 zijiexia 合并时间 2026-06-30 05:13 文件变更 2 提交数 1 评论 1 代码增减 +3 / -3

执行摘要

文档中 uv 安装添加 --prerelease=allow 参数

用户按照文档推荐的 uv pip install sglang 命令会静默安装 sglang 0.5.9 而非最新版本。根本原因是 sglang 0.5.10+ 依赖 flash-attn-4>=4.0.0b4 / >=4.0.0b9),而 flash-attn-4 在 PyPI 上仅发布预发布版本(4.0.0b34.0.0b19),uv 默认拒绝预发布版本,导致回溯至最后一个不需要 flash-attn-4 的 0.5.9 版本。而 pip 接受预发布版本所以正常安装最新版。

该 PR 内容简单直接,属于常规文档维护。无需精读。值得注意的设计决策是选择 --prerelease=allow 而非 --prerelease=if-necessary--prerelease=explicit,因为 flash-attn-4 是传递依赖,后两者无法生效。

讨论亮点

无 review 讨论。一名审核者(wisclmy0611)直接批准了变更。

实现拆解

  1. docs_new/docs/get-started/install.mdx 中找到两个 uv pip install sglang 命令位置(默认安装块和 CUDA 12 安装块),添加 --prerelease=allow 标志。
  2. docs_new/docs/get-started/quickstart.mdx 中的 Installation (Pip / uv) Tab 下,找到 uv pip install sglang 命令,添加 --prerelease=allow 标志。
  3. 已验证:添加 --prerelease=allow 后,uv pip install sglang 解析为 sglang==0.5.13.post1(附带 flash-attn-4==4.0.0b19 等依赖)。
文件 模块 状态 重要度
docs_new/docs/get-started/install.mdx 文档 modified 2.32
docs_new/docs/get-started/quickstart.mdx 文档 modified 2.14

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

评论区精华

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

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

风险与影响

风险极低。仅修改文档中两处 uv 安装命令,不影响任何代码逻辑或运行时行为。用户若之前已按旧命令安装,可能仍在使用旧版本 sglang,但本次变更仅更新文档,不自动升级现有环境。

影响范围较小,限于使用 uv 安装 sglang 的用户。变更后,这些用户将能通过文档推荐的命令获得最新 sglang 版本,避免因版本回溯导致的潜在兼容性问题或功能缺失。同时与 pip 用户的安装体验对齐。

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论