执行摘要

• 一句话：更新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一致。

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 的适配变更。