执行摘要

• 一句话：恢复 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. 添加的代码为：
   

   # 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，确保用户安装说明正确且完整。

# 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 相同的一行变更，可能是同一个修复的不同分支。