# PR #24181 完整报告

- 仓库：`sgl-project/sglang`
- 标题：Update kernel installation instructions after shifting default cuda to 13
- 合并时间：2026-05-03 07:07
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/24181

---

# 执行摘要

- 一句话：更新 sgl-kernel 安装提示适配 CUDA 12
- 推荐动作：无需深入阅读，属于紧跟上游依赖变更的维护性修改。可以作为如何保持安装提示信息与依赖版本同步的参考。

# 功能与动机

该 PR 是为了配合 #21247 (Upgrade to Torch 2.11.0) 中将默认 CUDA 版本从 13 切换为 12 的变更，确保 kernel 加载失败时给出的安装提示与实际 CUDA 版本匹配。

# 实现拆解

在文件 `sgl-kernel/python/sgl_kernel/load_utils.py` 的 `_load_architecture_specific_ops` 函数中，当所有加载尝试失败后，会检查 `torch.version.cuda`：
1. 将版本号前缀检查从 `startswith("13")` 改为 `startswith("12")`，以匹配新的默认 CUDA 12 版本。
2. 对应的 pip 安装索引 URL 从 `https://docs.sglang.ai/whl/cu130/` 改为 `https://docs.sglang.ai/whl/cu129/`。

关键文件：
- `sgl-kernel/python/sgl_kernel/load_utils.py`（模块 内核加载；类别 source；类型 configuration）: 唯一变更文件，修改了 CUDA 版本检查和安装提示 URL，确保与默认 CUDA 12 一致。

关键符号：未识别

## 关键源码片段

### `sgl-kernel/python/sgl_kernel/load_utils.py`

唯一变更文件，修改了 CUDA 版本检查和安装提示 URL，确保与默认 CUDA 12 一致。

```python
def _load_architecture_specific_ops():
    """
    加载架构特定的 common_ops 库。
    所有加载尝试失败后，提示用户正确的安装命令。
    """
    # ... 前面的加载逻辑 ...

    # All attempts failed
    cuda_version = torch.version.cuda
    # 检查 CUDA 版本前缀，决定推荐哪个 pip 源
    if cuda_version and cuda_version.startswith("12"):
        # 对 CUDA 12.x 系列，推荐 cu129 索引
        install_hint = (
            "pip install sglang-kernel --index-url https://docs.sglang.ai/whl/cu129/"
        )
    else:
        # 其他 CUDA 版本使用通用安装命令
        install_hint = "pip install --upgrade sglang-kernel"

    error_msg = f"""
[sgl_kernel] CRITICAL: Could not load any common_ops library!
...
Please ensure sgl_kernel is properly installed with:
{install_hint}
...
"""
    logger.debug(error_msg)
    raise ImportError(error_msg)

```

# 评论区精华

该 PR 没有 review 评论，变更简单直接，未引发讨论。

- 暂无高价值评论线程

# 风险与影响

- 风险：该变更为纯提示信息更新，不影响任何逻辑执行路径，风险极低。唯一的潜在风险是如果后续默认 CUDA 版本再次变更而未同步更新此提示，但这是任何硬编码提示的固有问题。
- 影响：影响范围极小：仅当 sgl-kernel 加载失败时，用户看到的安装提示会指向正确的 CUDA 12 索引 URL。对用户、系统性能和团队无实质影响。
- 风险标记：暂无

# 关联脉络

- PR #21247 [Dependency] Upgrade to Torch 2.11.0: 本 PR 动机中明确提到被 #21247 阻塞，是跟随其将默认 CUDA 版本从 13 切换为 12 的适配变更。