ComfyUI Portable 安装 SageAttention（cu130 + Torch 2.9）完整教程【修复 Triton 报错版】

一、说明（必须看）

ComfyUI Portable 版本默认：

• ❌ 没有虚拟环境（.venv）
• ❌ 缺少 Python 开发库（Include / libs）
• ❌ Triton 编译容易报错

👉 本教程已经完整修复这些问题

---

二、需要准备的文件

1️⃣ SageAttention

文件：

sageattention-2.2.0+cu130torch2.9.0andhigher.post4-cp39-abi3-win_amd64.whl

来源：SageAttention

---

2️⃣ Python 开发库（关键）

下载：

👉 python_3.13.x_include_libs.zip

来源：GitHub

---

3️⃣ Visual C++ 运行库（必须）

下载：

👉 https://aka.ms/vs/17/release/vc_redist.x64.exe

---

三、解压 Python 开发库（最重要一步）

解压到：

C:\Users\你的用户名\Documents\ComfyUI_windows_portable\python_embeded\

解压后结构必须是：

python_embeded\
├── Include\
│   └── Python.h
├── libs\
│   └── python313.lib

👉 这一步是修复 Triton 报错的核心

---

四、打开终端

进入：

C:\Users\你的用户名\Documents\ComfyUI_windows_portable\python_embeded

👉 地址栏输入：

cmd

---

五、安装 Torch（固定版本）

.\python.exe -m pip uninstall torch torchvision torchaudio -y

.\python.exe -m pip install torch==2.9.0+cu130 torchvision==0.24.0+cu130 torchaudio==2.9.0+cu130 --index-url https://download.pytorch.org/whl/cu130

---

六、安装 SageAttention

.\python.exe -m pip uninstall sageattention -y

.\python.exe -m pip install "..\sageattention-2.2.0+cu130torch2.9.0andhigher.post4-cp39-abi3-win_amd64.whl"

---

七、安装 Triton（关键）

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

.\python.exe -m pip install -U "triton-windows"

---

八、验证安装

.\python.exe -c "import torch; import sageattention; import triton; print('安装成功')"

---

九、启动 ComfyUI

run_nvidia_gpu_fast_fp16_accumulation.bat

---

十、如何判断是否成功？

启动后日志出现：

• sageattention 字样
• triton kernel 编译成功

👉 即代表成功

---

十一、常见报错解决

❌ 报错：tcc.exe / subprocess.CalledProcessError

原因：

👉 缺少 Python 开发库

解决：

✔ 解压 python_3.13.x_include_libs.zip

---

❌ 报错：cannot find -lcuda

原因：

👉 找不到 CUDA 库

解决：

👉 安装：
NVIDIA CUDA Toolkit 13.0

---

❌ 报错：Python was not found

👉 必须使用：

.\python.exe

---

十二、总结

通过本教程，你已经完成：

• 安装 Torch 2.9 + CUDA 13
• 安装 SageAttention
• 修复 Triton 编译问题
• 成功在 ComfyUI 中启用 AI 加速

👉 对 RTX 4090 用户性能提升明显

---

✅ 一句话总结

Portable 版核心关键：必须补 python313.lib + 正确 Triton 版本