ModuleNotFoundError: No module named 'transformers' in ComfyUI
修复 ComfyUI 启动时报 No module named transformers 的问题，并判断它是不是来自 ComfyUI 自己的文本栈。
你可以手动修复，也可以下载 Windows 版 Wonderful Launcher 自动诊断插件报错、依赖缺失和环境损坏，不用盲目重装。
免费下载 Windows 版如果 ComfyUI 启动时报 ModuleNotFoundError: No module named 'transformers'，不要先默认它只是某个插件的问题。
在当前 ComfyUI 代码里，这个错误可能来自 ComfyUI 自己的文本和 tokenizer 栈。真实实验环境里，traceback 经过了 comfy\sd1_clip.py，卡在 from transformers import CLIPTokenizer，而且发生在 server 启动之前。
快速处理
对 GitHub Windows 便携包：
.\python_embeded\python.exe -s -m pip show transformers tokenizers
Get-Content ComfyUI\requirements.txt | Select-String "transformers|tokenizers"
.\python_embeded\python.exe -s -m pip install transformers
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build如果下一次启动又出现新的核心缺包，不要跳去乱装别的东西，继续在同一个环境里处理新的第一条阻塞。
真实日志长什么样
实验环境里，关键 traceback 是这样的：
File "...\ComfyUI\comfy\sd1_clip.py", line 3, in <module>
from transformers import CLIPTokenizer
ModuleNotFoundError: No module named 'transformers'这很关键，因为它不是某个 random custom node 路径，而是 ComfyUI 自己的模型文本栈。
快速判断
| 你看到什么 | 代表什么 | 第一动作 |
|---|---|---|
No module named 'transformers'，而且来自 comfy\sd1_clip.py | ComfyUI 核心文本/tokenizer 依赖缺失 | 在 ComfyUI 当前 Python 里安装 transformers |
系统 Python 里 pip show transformers 有结果，但 ComfyUI 还报错 | 修错环境了 | 用 python_embeded\python.exe 或当前 venv |
本地 requirements.txt 里有 transformers>=... 和 tokenizers>=... | 当前代码本来就要求这组包 | 按同一个环境修这组包 |
装完 transformers 又冒出新的缺包 | 环境整体漂移，不是单点问题 | 继续看新的第一条阻塞 |
服务已经起来，只是某个插件报 transformers 缺失 | 可能是插件问题 | 但安装位置仍然必须是 ComfyUI 当前 Python |
第 1 步：先看本地 requirements
这次实验里，ComfyUI\requirements.txt 相关行是：
transformers>=4.50.3
tokenizers>=0.13.3你自己的环境先查本地文件：
Get-Content ComfyUI\requirements.txt | Select-String "transformers|tokenizers"这样你就知道当前 ComfyUI 代码是不是本来就要求这些包。
第 2 步：装到真正启动 ComfyUI 的 Python 里
Windows 便携包：
.\python_embeded\python.exe -s -m pip install transformers手动 venv：
python -m pip install transformers实验里，这一步同时拉进来了 tokenizers、huggingface-hub、regex 这些相邻依赖。
如果你用的是 ComfyUI Desktop 或别的托管启动器，就要在它自己的环境里装，不要用另一个独立 Python。
第 3 步：重启，看新的第一条阻塞
重新启动：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build这次实验里，transformers 修好之后，下一条新的阻塞变成了：
ModuleNotFoundError: No module named 'torchsde'这很正常。坏掉的便携环境经常不是只少一个包。正确做法不是猜十个包一起装，而是继续处理新的第一条阻塞。
第 4 步：区分核心错误和插件错误
如果 traceback 指向：
ComfyUI\comfy\sd1_clip.pyComfyUI\comfy\supported_models.pyComfyUI\comfy\sd.py
那这个 transformers 缺失就属于 ComfyUI 核心文本栈。
如果 traceback 指向 custom_nodes 下面的插件文件，那可能是插件专属问题。但不管怎样，安装位置依然必须是启动 ComfyUI 的那个 Python。
不要做这些事
- 不要把
transformers装到系统 Python，而 ComfyUI 实际跑的是python_embeded - 不要一看到
transformers缺失，就先去降级 Torch、NumPy、Pillow - 不要没看 traceback 路径，就默认一定是插件问题
- 不要不重启验证，连续安装很多包
Wonderful Launcher 能帮什么
Tokenizer 和模型文本栈这类错误，难点通常不是包名本身，而是你到底能不能确认：哪个 Python 在跑 ComfyUI，traceback 又到底来自核心代码还是插件。Wonderful Launcher 对这种问题会更友好，因为环境边界和日志来源更清楚。
相关指南
- ComfyUI 便携版依赖损坏后，按一个报错一个包修启动
- ModuleNotFoundError: No module named 'torch' in ComfyUI
- comfyui-frontend-package is not installed in ComfyUI
- ComfyUI Startup Failed
- ComfyUI No module named 警告：什么时候可以忽略
来源与实测
- 2026-05-18 Windows 便携版实验：traceback 在
ComfyUI\comfy\sd1_clip.py的from transformers import CLIPTokenizer处失败 - 同一实验
ComfyUI\requirements.txt：包含transformers>=4.50.3和tokenizers>=0.13.3 - 同一实验里，修好
transformers后下一条阻塞是ModuleNotFoundError: No module named 'torchsde'
你可以手动修复，也可以下载 Windows 版 Wonderful Launcher 自动诊断插件报错、依赖缺失和环境损坏，不用盲目重装。
免费下载 Windows 版你可以手动修复，也可以下载 Windows 版 Wonderful Launcher 自动诊断插件报错、依赖缺失和环境损坏，不用盲目重装。
免费下载 Windows 版Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.