No module named ‘triton’

快速结论：这个报错通常出现在 Stable Diffusion WebUI Forge 启动时，日志里出现 No module named 'triton'，同时用户以为 Civitai Helper 按钮不显示是 WebUI 或 Forge 本身的问题。优先排查扩展兼容性，而不是 Triton 缺失本身。

适用环境：Stable Diffusion WebUI Forge，Windows；Python 3.10.6；torch 2.0.1+cu118；xformers 0.0.17；NVIDIA GeForce RTX 2060 6GB；浏览器为 Google Chrome。

最快修复方案：Issue 中验证有效的做法是改用 blue-pen5805/Stable-Diffusion-Webui-Civitai-Helper 这个 fork；装好后如果仍不显示按钮，再到 Forge 的 Settings > Civitai Helper 中勾选 “Always Display Buttons on model cards”。

注意事项：原版 zixaphir 扩展在 Forge 以及 A1111 dev 分支中按钮可能本来就不可用，属于扩展侧兼容问题；Triton 缺失只是 xformers 的优化警告，不等于 Civitai Helper 按钮消失的直接原因。

问题场景

用户使用 Stable Diffusion WebUI Forge，安装 zixaphir/Stable-Diffusion-Webui-Civitai-Helper 扩展后，期望在 LORA 卡片上方看到 Civitai Helper 按钮，但按钮没有出现。

启动日志中同时出现 xformers 相关警告：No module named 'triton'。不过根据 Issue 后续讨论，按钮不显示的主要问题指向扩展与 Forge/A1111 dev 分支的兼容性，而不是 Triton 模块本身。

报错原文

WARNING:xformers:A matching Triton is not available, some optimizations will not be enabled.
Error caught was: No module named 'triton'
xformers version: 0.0.17
...
You are running torch 2.0.1+cu118.
The program is tested to work with torch 2.1.2.
...
You are running xformers 0.0.17.
The program is tested to work with xformers 0.0.23.post1.

原因分析

从 Issue 讨论看，Civitai Helper 按钮不显示更可能是扩展本身没有跟上 A1111 dev 分支的界面变化。No module named 'triton' 是 xformers 在检测不到 Triton 时给出的警告，表示部分优化不会启用，但 Issue 中没有证据表明它直接导致 Civitai Helper 按钮消失。

原版 zixaphir 扩展在 Forge 和 A1111 dev 分支中按钮可能已经失效；Forge 与 A1111 dev 分支同步后，模型浏览方式、UI 结构发生变化，旧扩展没有同步适配。

可能的解决方向不是强行安装 Triton，而是更换已经验证可用的 Civitai Helper fork。

环境排查

确认使用的是 Stable Diffusion WebUI Forge，而不是原版 A1111。
确认 Python 版本为 3.10.6。
确认 torch 版本为 2.0.1+cu118；Forge 日志提示测试版本为 2.1.2。
确认 xformers 版本为 0.0.17；Forge 日志提示测试版本为 0.0.23.post1。
确认显卡为 NVIDIA GeForce RTX 2060，显存 6GB。
确认当前安装的是 zixaphir 原版 Civitai Helper，还是 blue-pen5805 fork。
确认启动参数中是否包含 --always-gpu --xformers 等；Issue 中使用的启动参数包含这些选项。
确认 Forge 设置里 Settings > Civitai Helper 的按钮显示选项是否已开启。

解决步骤

如果安装的是 zixaphir/Stable-Diffusion-Webui-Civitai-Helper，先不要把它当作 Forge 本身的故障处理。Issue 中维护者说明这属于扩展侧问题，需要到扩展仓库反馈。
可优先尝试替换为 Issue 中用户验证可用的 fork：blue-pen5805/Stable-Diffusion-Webui-Civitai-Helper。
安装该 fork 后重启 Forge，检查 LORA 卡片上方是否出现 Civitai Helper 按钮。
如果按钮仍然不显示，进入 Forge 的 Settings > Civitai Helper，找到并勾选 Always Display Buttons on model cards。
保存设置并重启 WebUI，再次检查 LORA 卡片区域。
若仍无效，回到扩展仓库反馈，并附上 Forge 版本、扩展版本、启动日志和系统信息；不要仅凭 No module named 'triton' 判断问题根源。

验证方法

重启 Forge 后打开包含 LORA 卡片的界面，确认 LORA 卡片上方正常显示 Civitai Helper 按钮。Issue 中用户反馈更换 blue-pen5805 fork 后按钮可用，并在设置中开启 “Always Display Buttons on model cards” 后可见。

如果按钮已经出现，即使启动日志里仍有 No module named 'triton'，也说明该警告与按钮显示问题不是同一个故障。