Prhub

#26344 [Doc] Update pip install commands for Cuda12

原始 PR 作者 Fridge003 合并时间 2026-05-26 13:28 文件变更 1 提交数 1 评论 2 代码增减 +10 / -0

执行摘要

更新 CUDA 12 安装命令到文档

默认的 CUDA major 版本是 13,使用 CUDA 12 的用户需要安装命令指导。

可直接合并,文档变更轻量且无副作用。建议后续维护者关注 cu129 索引 URL 是否正确指向 CUDA 12 包。

讨论亮点

该 PR 没有收到 review 评论,只有一个 Mintlify 预览部署的自动评论,显示文档预览已就绪。

实现拆解

  1. docs_new/docs/get-started/install.mdxpip install sglang 章节后新增了一段说明和命令块,用于指导 CUDA 12 用户通过 pip 和 uv 安装 sglang,包括强制重装适配的 torch 和 sglang-kernel 等。
  2. 新增的命令块展示了完整步骤:升级 pip、安装 uv、使用 uv 安装 sglang,并通过 --force-reinstall 替换 torch 和 sglang-kernel 的 CUDA 12 兼容版本。
文件 模块 状态 重要度
docs_new/docs/get-started/install.mdx 文档 modified 2.76

关键源码片段

docs_new/docs/get-started/install.mdx documentation

文档文件,添加了 CUDA 12 的安装命令,是 PR 的唯一变更文件。

# CUDA 12 安装命令(默认 CUDA major 为 13)
pip install --upgrade pip
pip install uv
uv pip install sglang
# 强制重装适配 CUDA 12 的 torch 和 kernel
uv pip install --force-reinstall torch==2.11.0 torchaudio==2.11.0 torchvision --index-url https://download.pytorch.org/whl/cu129
uv pip install --force-reinstall sglang-kernel --index-url https://docs.sglang.ai/whl/cu129/
uv pip install --force-reinstall sgl-deep-gemm --index-url https://docs.sglang.ai/whl/cu129/ --no-deps

评论区精华

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

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

风险与影响

无代码变更,仅为文档更新,引入回归或性能风险的概率极低。但需确保命令中的索引 URL(如 https://docs.sglang.ai/whl/cu129/)与实际发布的 wheel 包一致,否则用户可能遇到安装失败。

影响范围限于使用 CUDA 12 的 sglang 用户,提供了明确的安装步骤,降低了新用户配置门槛。对系统其他模块无影响。

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论