知仓学习社知仓学习社
WanVideoWrapper：No module named 'sageattention'（SageAttention 未安装或装错环境） / 全站资源搜索
搜索 更新 2026-10-02
报错 104 热门自定义节点/工作流专有报错 含未核实说明

WanVideoWrapper：No module named 'sageattention'（SageAttention 未安装或装错环境）

报错原文（原样） 
WanVideoModelLoader - No module named 'sageattention'
检索关键词 No module named 'sageattention'、sageattention、WanVideoWrapper、WanVideoModelLoader、triton、Can't import SageAttention
先看这一句 用 kijai 的 WanVideoWrapper 跑 Wan 视频工作流，点运行时立刻报 No module named 'sageattention'；即使模型、VAE、文本编码器都放对了也跑不动。
适用版本 WanVideoWrapper 支持 sageattention 之后的所有版本；不选该后端时可回避 · 核实日期 2026-09-26 · 状态 可能已过期，正在复核
适用环境：Windows 便携版、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 照着工作流作者的截图用了 sageattention 加速选项，但自己没装该库
  • 装过 sageattention 但装到了系统 Python，便携版环境里没有
  • 装了 sageattention 但缺少匹配的 triton，运行时报导入失败

根因

  • WanVideoWrapper 的注意力后端支持 sageattention/flash-attn 等可选项，节点把所选后端作为硬依赖直接 import；该库属于编译型 CUDA 扩展，默认不在任何 ComfyUI 依赖里，未安装即抛 ModuleNotFoundError
  • sageattention 在 Windows 上需要能编译 CUDA 扩展（或使用预编译 wheel），且依赖 triton；只有 torch 是不够的
  • 云端/Kaggle/Colab 镜像里通常预装不全，社区讨论中大量出现「WANWRAPPER 没有 sage attention」的提问

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 最快的办法：把节点的注意力模式改回默认，不依赖 sageattention
    WanVideoModelLoader 里有一个注意力模式/attention_mode 之类的选项。先把它切回 sdpa（PyTorch 自带）或 flash_attn（若已装），不要选 sageattention。这样不改环境就能先把工作流跑通，确认模型路径等其它配置都对；之后再单独处理加速库。
  2. 确认库里到底有没有装到 ComfyUI 用的那个环境
    先在便携版解释器里查这个包是否存在，再决定装不装。很多人是装过但从没装进 ComfyUI 的环境，查一下就能确认。
    ..\..\python_embeded\python.exe -c "import sageattention, sys; print(sageattention.__file__)"
    ..\..\python_embeded\python.exe -m pip list | findstr /i "sageattention triton"
  3. 用便携版内置 Python 安装 sageattention 与 triton
    确认缺失后，用便携版解释器安装。sageattention 是编译型扩展，Windows 上通常需要预编译 wheel 或已配置好的 CUDA 编译环境；如果本地编译失败，优先按 WanVideoWrapper issue 与社区教程里给出的预编译 wheel 安装方式处理，不要强行源码编译。triton 版本必须与当前 torch/CUDA 匹配。
    ..\..\python_embeded\python.exe -m pip install sageattention
    ..\..\python_embeded\python.exe -m pip install triton-windows
  4. 装完重启，并核对显存是否够（sageattention 只是加速，不是省显存方案）
    安装完成后完全重启 ComfyUI，再跑一次。若换成 flash_attn 路线，参见 WanVideoWrapper issue #1317（Flash Attention 版本适配问题），注意 flash-attn 与 torch/CUDA 的匹配关系；显存不足请改小分辨率/帧数或使用该节点的分块、offload 相关选项。

验证是否修好

在便携版解释器里执行 import sageattention 不再报错；WanVideoModelLoader 选择 sageattention 后执行不再抛 ModuleNotFoundError，且能正常出帧。

补充说明

error_text 取自 kijai/ComfyUI-WanVideoWrapper issue #10 标题原文。另官方仓库 issue #11195 标题为 'WanVideoModelLoader: Can't import SageAttention after trying to install ultravico'（ultravico 应为 ultralytics 笔误），说明安装了别的包并不会顺带装上 sageattention。triton-windows 这个包名未在本次搜索结果中逐字确认，标注 [未核实]，实际以 sageattention 官方/issue 给出的安装方式为准。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [233] （节点仓库 issue）　WanVideoModelLoader - No module named 'sageattention'　https://github.com/kijai/ComfyUI-WanVideoWrapper/issues/10
  2. [234] （官方 issue）　WanVideoModelLoader: Can't import SageAttention after trying to instal　https://github.com/Comfy-Org/ComfyUI/issues/11195
  3. [235] （节点仓库 issue）　Flash Attention 2.8.3　https://github.com/kijai/ComfyUI-WanVideoWrapper/issues/1317
本条的可靠性边界 下面这些位置带 [未核实] 标记，是采集时没找到一手来源的部分，请自行验证：
  • 补充说明

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

kijai/ComfyUI-WanVideoWrapper 节点库

这条报错要用到的东西

按本条报错所属的类别（热门自定义节点/工作流专有报错）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
节点库找到对应节点仓库，看它的适配模型 板块 工作流看官方模板里这条工作流本来是怎么连的 板块

同一类别的其他条目

【100】打开别人的工作流，节点全变红，提示节点缺少 class_type 属性 有来源 【101】ComfyUI-Manager 连不上 Comfy Registry，刷新缓存失败 含未核实 【102】ComfyUI-Impact-Pack 导入失败：No module named 'ultralytics'（缺少检测模型依赖） 有来源 【103】comfyui_controlnet_aux 导入失败：No module named 'timm' 有来源 【105】VideoHelperSuite：ffmpeg is required for video outputs and could not be found 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库