# PR #27287 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs(cookbook): add Docker install option for Gemma 4
- 合并时间：2026-06-05 03:45
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/27287

---

# 执行摘要

- 一句话：Gemma 4 cookbook 新增 Docker 安装说明
- 推荐动作：可直接合并。建议后续关注 Docker 镜像的更新频率，以及是否需要同步更新其他 cookbook 的 Docker 安装说明。

# 功能与动机

为 Gemma 4 用户提供更便捷的安装方式，避免手动从源码构建；同时修复过时的 transformers 依赖锁定。

# 实现拆解

1. **新增 Docker 安装小节**：在 `docs_new/cookbook/autoregressive/Google/Gemma4.mdx` 的 §2 安装章节中新增一个子章节，列出三个预构建镜像标签及对应的 CUDA 版本，并提供一个 `docker run` 命令示例，与已有的 pip-from-source 指令并列。
2. **删除过时的 transformers pin**：移除原先 `pip install 'git+...transformers.git@1423d22...'` 这一行，因为该 pin 已经过时，改用 SGLang 自身的依赖解析来安装 transformers。
3. **文档结构维持**：其余内容未变，仅调整了安装章节的编排。

关键文件：
- `docs_new/cookbook/autoregressive/Google/Gemma4.mdx`（模块 文档；类别 other；类型 documentation）: 唯一变更文件，新增 Docker 安装小节并删除过时的 transformers commit pin。

关键符号：未识别


# 评论区精华

审核人 kpham-sgl 感谢贡献并请求删除仍残留的 'pip install transformers commit' 行。PR 作者在 commit 中已处理。无其他讨论。

- 删除过时的 transformers pin (correctness): PR 作者在第二个 commit 中已删除该行，问题已解决。

# 风险与影响

- 风险：纯文档变更，无代码路径修改，风险极低。但需确保 Docker 镜像标签的生命周期（如旧版本不再维护）不会误导用户使用已过时的镜像。
- 影响：影响范围限于 Gemma 4 cookbook 的读者。对已有通过 pip 安装的用户无影响；对希望使用 Docker 的用户提供了零配置的启动方式。
- 风险标记：纯文档变更 , 依赖外部 Docker 镜像更新

# 关联脉络

- PR #27167 Gemma 4 support: 本 PR 引用的 Gemma 4 支持 PR，是本次 Docker 安装功能的基础。