问题类型:缺步骤 / 没讲清楚
文档:docs/zh/develop/torch_extension_develop_guide.md
严重程度:会让人困惑 / 走弯路或误判,但能恢复

问题

「安装依赖」一节的代码块标成 bash,但里面其实是 requirements 风格的包名清单、不是可执行命令;也没有 pip install。

读者会遇到什么

读者照抄到终端:numpy<2 会被 shell 当成重定向(报错或建出空文件),其它行也只是包名,根本不会安装任何依赖。

文档原文

docs/zh/develop/torch_extension_develop_guide.md(第 157–162 行)·标成 bash 的依赖清单:

 157 | ```bash
 158 | build
 159 | pyyaml
 160 | numpy<2
 161 | pytest
 162 | ```

代码原文 / 实际情况(去仓核对)

examples/fast_kernel_launch_example/requirements.txt(第 1–6 行)·仓里真实的依赖清单写法(同样这几个包):

   1 | --extra-index-url https://download.pytorch.org/whl/cpu
   2 | 
   3 | build
   4 | pyyaml
   5 | numpy<2
   6 | pytest

代码位置(完整指引)

• torch_extension_develop_guide.md:157-162 依赖清单(标成 bash)
• scripts/torch_extension/build_torch_extension.sh:172 python3 -m build(需要 build 包)
• examples/fast_kernel_launch_example/requirements.txt 仓内真实清单写法

建议改为

把代码块改成可执行命令,如 pip install build pyyaml 'numpy<2' pytest;或把语言标成 text/requirements 并说明「这是 requirements.txt 内容,用 pip install -r 安装」。