# PR #27321 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs(cookbook): restore Gemma 4 transformers commit pin
- 合并时间：2026-06-05 08:43
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/27321

---

# 执行摘要

- 一句话：恢复 Gemma 4 cookbook 中 transformers 提交锁定
- 推荐动作：可直接合并。该修复简单且关键，避免用户因缺少 pin 而遇到模型加载失败。

# 功能与动机

PR #27287 从 pip 安装路径中移除了 transformers 的 commit pin，但 SGLang main 需要 `transformers` 的特定提交（1423d22f）才能支持 Gemma 4 的 encoder-free unified 家族，而该功能尚未发布到任何 `transformers` 发行版。因此必须重新加上 pin，否则新的 `pip install transformers` 会拉取无法加载 `gemma-4-12B-it` 的版本。

# 实现拆解

1. 修改 `docs_new/cookbook/autoregressive/Google/Gemma4.mdx` 文件中第 2 节（安装说明）：在 pip install 命令后添加一行注释和命令，用于安装特定 commitchange 的 transformers。
2. 添加的代码为：
   ```bash
   # Install transformers with Gemma 4 support (encoder-free unified family included)\n   pip install 'git+https://github.com/huggingface/transformers.git@1423d22f7a3b62e8c70ad67b58ec25cd9b675897'
   ```
3. 同时更新了上方的说明文字，提示用户安装匹配的 transformers commit。

关键文件：
- `docs_new/cookbook/autoregressive/Google/Gemma4.mdx`（模块 文档；类别 docs；类型 configuration）: 唯一的变更文件，恢复了 transformers commit pin，确保用户安装说明正确且完整。

关键符号：未识别

## 关键源码片段

### `docs_new/cookbook/autoregressive/Google/Gemma4.mdx`

唯一的变更文件，恢复了 transformers commit pin，确保用户安装说明正确且完整。

```bash
# lines from Gemma4.mdx showing the restored pin
Command
# Install SGLang from main
pip install 'git+https://github.com/sgl-project/sglang.git#subdirectory=python'

# Install transformers with Gemma 4 support (encoder-free unified family included)
pip install 'git+https://github.com/huggingface/transformers.git@1423d22f7a3b62e8c70ad67b58ec25cd9b675897'

```

# 评论区精华

没有 review 评论。

- 暂无高价值评论线程

# 风险与影响

- 风险：低风险：仅涉及文档更新，不修改任何代码逻辑。唯一风险是如果未来 transformers 合并了该功能并发布，pin 可能过时，但那时可再次更新文档。
- 影响：仅影响 Gemma 4 cookbook 的读者（用户）。确保他们按照文档安装时能够正确加载 Gemma 4 模型。对其他功能无影响。
- 风险标记：暂无

# 关联脉络

- PR #27287 docs(cookbook): add Docker install option for Gemma 4: 本 PR 正是修复 #27287 引入的问题：该 PR 在添加 Docker 选项时意外删除了 transformers commit pin。
- PR #27319 Same one-line change in another branch?: PR body 中提到与 #27319 相同的一行变更，可能是同一个修复的不同分支。