Prhub

#6174 [doc] chore: fix ascend qucik start

原始 PR 作者 wucong25 合并时间 2026-04-27 19:41 文件变更 1 提交数 1 评论 0 代码增减 +0 / -2

执行摘要

修正 Ascend 快速启动文档中的错误指令

修复 Ascend NPU 快速启动文档中的错误:用户反馈设置 VLLM_ATTENTION_BACKEND=XFORMERS 会导致 vLLM 启动失败(Issue #6142),并且容器默认在根目录执行时也会报错。本次 PR 删除了不兼容的环境变量设置。

此 PR 为简单的文档修复,建议快速合并。后续应关注 Issue #6142 中关于容器根目录执行的问题,可能需要补充工作目录说明或路径处理。

讨论亮点

无 review 讨论。审核机器人 gemini-code-assist 自动评论确认变更内容,ArronHZG 直接批准。

实现拆解

docs/ascend_tutorial/quick_start/ascend_quick_start.rst 文件中删除两行:

  1. 移除 export VLLM_ATTENTION_BACKEND=XFORMERS,因为 XFORMERS 是 NVIDIA 的注意力后端,Ascend NPU 不兼容。
  2. 移除相关空行(实为同一行删除)。

该 PR 仅涉及文档变更,无任何源码改动。

文件 模块 状态 重要度
docs/ascend_tutorial/quick_start/ascend_quick_start.rst 文档 modified 1.32

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

删除不兼容的环境变量 正确性

删除 export VLLM_ATTENTION_BACKEND=XFORMERS 行,避免 Ascend NPU 上 vLLM 启动失败。

结论:已删除。 · 已解决

风险与影响

风险极低:仅删除文档中一行错误的环境变量设置,不影响任何功能逻辑。但 Issue #6142 还提到不能在容器根目录执行的问题未被修复,需后续跟进。

对用户:修复了 Ascend NPU 用户按照文档运行时遇到的 vLLM 启动失败问题,提高了文档的准确性和易用性。对系统:无影响。对团队:极小的文档维护工作。影响范围仅限于 Ascend 快速启动文档读者。

问题未完全修复(容器根目录执行问题)

关联 Issue

#6142 【ascend】quickstart 的 example 运行问题

完整报告

参与讨论