xFormers 已安装却不可用：检查扩展构建与实际解释器

现象与适用范围

启动或采样时提示 xFormers 的 C++/CUDA 扩展无法加载，或者找不到支持当前输入的 attention 算子。pip 列出包已安装，只能说明 Python 分发包存在，不能证明其中的 GPU 内核可以运行。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

xFormers can't load C++/CUDA extensions
No operator found

已核对的依据

xFormers 项目提供独立的 info 检查命令，并按 PyTorch 和运行平台给出安装条件。ComfyUI 的排错文档也区分核心流程与第三方扩展，因此应先判断失败是否仅由可选加速组件引起。 R05 P04 D02 ComfyUI 启动选项源码

需要区分的情况

1. 安装 xFormers 时使用了系统 Python，而 ComfyUI 使用另一个虚拟环境或 Portable 解释器。

2. 二进制扩展针对不同的 Torch/CUDA/Python 构建，或当前设备、dtype、输入布局没有可用算子。

3. 某自定义节点明确强制使用 xFormers，即使核心可以使用其他注意力实现，那个节点仍可能失败。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 使用运行 ComfyUI 的解释器执行 info，并保存版本、可用算子和加载失败原因。不要只截图 pip 安装成功。

第 2 步。 对照 xFormers 当前安装说明，核对 Torch、计算后端、设备和平台；升级扩展前检查是否会连带替换现有 Torch。

第 3 步。 在环境副本中查看当前 ComfyUI 的 --help，选择该版本支持的非 xFormers 注意力路径，再用同一原生基础工作流对照。不要假定默认路径排除了 xFormers，也不要把单个参数视为全版本通用。

第 4 步。 只有确认缺少兼容二进制且具备编译条件时才考虑源码构建；否则选择相容的软件组合或不依赖该扩展的流程。

可复制的检查命令

在 Portable 根目录运行：

.\python_embeded\python.exe -m xformers.info

独立虚拟环境中使用该环境的 python -m xformers.info。

如何判断处理有效

info 显示目标算子可用只是第一层验证；还需同一工作流的小尺寸请求通过，日志实际选择的后端与预期一致。

注意事项与尚未确认的部分

不要从不明网盘获取所谓通用修复 wheel；扩展会执行本地代码。不能保证更换注意力后数值结果、耗时完全相同。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• R05 · xFormers README。核对：2026-09-21。
• P04 · PyTorch local installation。核对：2026-09-21。
• D02 · ComfyUI custom node troubleshooting。核对：2026-09-21。
• ComfyUI 启动选项源码。核对：2026-09-25。

相关排查与操作

• SageAttention / Triton 导入失败：先核对平台与版本组合
• no kernel image is available：显卡计算能力与二进制构建不匹配