# PR #22852 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Docs] Move ptxas sm_103a workaround into For CUDA 13 section
- 合并时间：2026-04-15 13:30
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/22852

---

# 执行摘要

- 一句话：将 B300/GB300 的 ptxas 警告从文档底部移至 CUDA 13 安装步骤，提升可发现性。
- 推荐动作：该 PR 变更简单直接，属于文档维护性改进。对于工程师而言，无需深入阅读代码，但可以关注此次调整所体现的 **文档可发现性设计原则 **——将问题解决方案放置在用户最可能遇到的上下文附近，而非通用的“杂项”区域。这对于编写用户友好的技术文档有借鉴意义。

# 功能与动机

根据 PR 描述，原工作区说明被放置在文档底部的“通用注意事项”中，对于使用 CUDA 13 在 B300/GB300 上通过 pip 安装 SGLang 的用户来说，该修复方法不易被发现。移动该说明到“针对 CUDA 13”章节的安装步骤之后，可以使用户在遇到问题时能更直接地找到解决方案，无需翻阅整个文档。

# 实现拆解

1. **定位变更文件**：本次变更仅涉及一个文件 `docs/get_started/install.md`，属于文档类修改。
2. **调整文档结构**：在“针对 CUDA 13”章节的安装命令后（步骤 3 之后）新增步骤 4，内容为遇到特定 ptxas 错误时的环境变量设置方法（`export TRITON_PTXAS_PATH=/usr/local/cuda/bin/ptxas`）。
3. **清理冗余内容**：从文档底部的“通用注意事项”列表中移除相同的工作区说明条目，避免内容重复。
4. **无配套改动**：本次变更不涉及源码、测试、配置或部署文件的修改，仅为纯文档结构调整。

关键文件：
- `docs/get_started/install.md`（模块 安装指南；类别 docs；类型 documentation）: 这是本次 PR 唯一修改的文件，包含了 SGLang 的安装指南。变更调整了文档结构，将特定硬件 / 环境下的错误修复说明移动到更相关的位置，直接影响用户安装体验。

关键符号：未识别


# 评论区精华

本次 PR 未产生任何 review 评论或讨论，直接由维护者 ishandhanani 合并。这表明变更内容清晰、目标明确，且属于低风险的文档改进，无需额外技术讨论。

- 暂无高价值评论线程

# 风险与影响

- 风险：**技术风险极低**。
- **回归风险**：无，仅修改文档内容，不影响任何代码逻辑、构建流程或运行时行为。
- **兼容性风险**：无，文档调整不改变软件功能或接口。
- **内容准确性风险**：需确保移动后的说明在上下文中仍准确无误。从变更内容看，工作区方法本身未变，仅位置调整，风险可控。
- 影响：**影响范围有限但正面**。
- **对用户**：提升了安装文档的可用性，特别是针对使用 CUDA 13 和 B300/GB300 硬件的用户，能更快地找到解决特定错误的方法，改善初次使用体验。
- **对系统**：无影响，不改变软件功能、性能或稳定性。
- **对团队**：维护了文档的清晰度和结构合理性，为后续文档更新提供了更合理的组织范例。
- 风险标记：暂无

# 关联脉络

- 暂无明显关联 PR