ComfyUI 安装 Triton-Windows 教程：解决 Torch 与 xFormers 不兼容问题的完整指南

Meta 描述：想让你的 ComfyUI 在 Windows 上完美运行？本教程详细介绍如何安装兼容的 Triton-Windows 版本，解决 “Cannot set attribute ‘src’” 报错，适配 Torch 2.6.0 与 xFormers 0.0.28，支持 RTX 4090 等 GPU。

---

一、前言：为什么需要安装 Triton-Windows？

在 Windows 上使用 ComfyUI 时，许多用户会遇到以下错误：

AttributeError: Cannot set attribute 'src' directly. Use '_unsafe_update_src()'...

这个问题的根源是：

• xFormers 与 Triton 版本不兼容
• 官方 Triton 不支持 Windows 编译
• ComfyUI 默认环境使用 Conda 封装，无法直接用 pip 获取合适版本

👉 解决方案就是安装社区移植的 Triton-Windows 项目。

---

二、环境准备

✅ 系统与硬件要求

• Windows 10 或 Windows 11
• NVIDIA 显卡（推荐 RTX 4090 / 4080 / 3090）
• CUDA 12.6 驱动以上
• ComfyUI 官方客户端（自带 Python 环境）

---

三、常见错误与原因分析

错误提示	原因说明
Cannot set attribute 'src' directly	Triton 版本过高，与 xFormers 不兼容
xFormers can't load C++/CUDA extensions	xFormers 编译版本不匹配当前 Torch
No matching distribution found for triton==2.3.1	官方 Triton 不支持 Windows

---

四、正确安装顺序（推荐组合）

📦 第一步：进入 ComfyUI 主目录

cd "C:\Users\你的用户名\Documents\ComfyUI"

📦 第二步：卸载错误版本的 Triton

.\.ext\python.exe -m pip uninstall -y triton triton-windows

📦 第三步：安装兼容的 Triton-Windows 版本

.\.ext\python.exe -m pip install "triton-windows==3.2.0.post17"

📦 第四步：确保 PyTorch 与 xFormers 版本匹配

推荐版本如下：

torch==2.6.0+cu126
torchvision==0.21.0+cu126
torchaudio==2.6.0+cu126
xformers==0.0.28.post3

如需安装，可执行：

.\.ext\python.exe -m pip install torch==2.6.0+cu126 torchvision==0.21.0+cu126 torchaudio==2.6.0+cu126 xformers==0.0.28.post3 --extra-index-url https://download.pytorch.org/whl/cu126

---

五、启动验证

重启 ComfyUI 后，如果在日志中看到以下输出：

pytorch version: 2.6.0+cu126
xformers version: 0.0.28.post3
Using pytorch attention

✅ 恭喜！说明安装成功，错误 Cannot set attribute 'src' 将不再出现。

---

六、常见问答（FAQ）

Q1：Triton-Windows 是什么？
A：它是来自 GitHub 项目 woct0rdho/triton-windows 的非官方移植版，让 Windows 用户能正常运行 xFormers 和 Torch 的内核加速。

Q2：是否需要手动配置环境变量？
A：不需要。ComfyUI 的 .ext 环境是独立虚拟环境，执行路径已自动包含 Python 依赖。

Q3：如何防止 ComfyUI-Manager 自动更新导致冲突？
A：在 ComfyUI-Manager 设置中关闭 “Auto update dependencies”，或执行以下命令锁定依赖：

.\.ext\python.exe -m pip freeze > requirements.lock

---

七、结语

通过本教程，你已经学会了：

• 如何在 Windows 安装兼容版 Triton-Windows
• 解决 xFormers 与 Torch 的版本冲突
• 让 ComfyUI 在 RTX 4090 上稳定运行

🚀 推荐稳定组合：

Torch 2.6.0 +cu126
Triton-Windows 3.2.0.post17
xFormers 0.0.28.post3

如果遇到 “No matching distribution” 或 “CUDA provider not found” 等错误，建议执行：

.\.ext\python.exe -m pip cache purge

---

🏷️ 建议标签（Tags）

ComfyUI, Triton-Windows, xFormers, PyTorch, AI绘图, RTX4090, Windows安装, Diffusers, CUDA