ComfyUI 提示 No module named 'transformers'：怎么修
在正确的 Python 环境里修复 transformers 缺失，并判断问题来自 ComfyUI 核心文本栈还是某个插件。
如果 ComfyUI 启动时出现 ModuleNotFoundError: No module named 'transformers'，不要先假设它只是某个插件的问题。
在最近的 ComfyUI 版本里，这个错误也可能直接来自 ComfyUI 自己的文本和 tokenizer 栈。也就是说，问题不一定在自定义节点，而可能已经在核心启动路径里。
先给结论
如果你用的是 GitHub 官方 Windows portable 包，先按这个顺序做：
.\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>=4.50.3"
.\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'这里很关键：报错路径在 ComfyUI\comfy\sd1_clip.py，这说明缺失的是 ComfyUI 自己的文本栈依赖，不是随机插件。
快速判断
| 你看到什么 | 说明什么 | 第一动作 |
|---|---|---|
No module named 'transformers' 来自 comfy\sd1_clip.py | 核心 tokenizer 依赖缺失 | 在 ComfyUI 当前 Python 里安装 transformers |
系统 Python 里 pip show transformers 正常，但 ComfyUI 仍报错 | 你装错环境了 | 改用 python_embeded\python.exe 或当前 venv |
本地 requirements.txt 里已经有 transformers>=...、tokenizers>=... | ComfyUI 本身就依赖这一组包 | 在同一个环境补齐它 |
装完 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"如果这里已经明确列出依赖，那就更说明它不是“多余包”，而是当前代码路径本来就要用。
第 2 步：把包装进真正启动 ComfyUI 的 Python
Windows portable：
.\python_embeded\python.exe -s -m pip install "transformers>=4.50.3"手动 venv：
python -m pip install "transformers>=4.50.3"很多时候，这还会连带把 tokenizers、huggingface-hub、regex 等配套包一起补齐。
如果你用的是 ComfyUI Desktop 或其他受管 Launcher，也一样要装进它实际使用的环境。
第 3 步：重启，只看下一个阻塞
重新启动 ComfyUI：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build在坏掉的 portable 环境里，transformers 往往不是最后一个缺包。
装完它之后，下一条阻塞可能会变成：
ModuleNotFoundError: No module named 'torchsde'这并不奇怪。重点是：不要一次猜十个包。继续在同一个环境里修“新的第一错误”。
第 4 步：区分核心报错和插件报错
如果 traceback 指向：
ComfyUI\comfy\sd1_clip.pyComfyUI\comfy\supported_models.pyComfyUI\comfy\sd.py
那基本是 ComfyUI 核心文本栈依赖缺失。
如果 traceback 指向 custom_nodes/ 下面的某个插件目录，则更可能是插件自己的依赖问题。
但修法仍然一样：装进 同一个 ComfyUI Python 环境。
不要这样做
- 不要把
transformers装进系统 Python，而 ComfyUI 实际跑的是python_embeded - 不要在第一条错误只是缺
transformers时，就先去降级 Torch、NumPy 或 Pillow - 不要因为看到插件名字，就直接认定核心 ComfyUI 没问题
- 不要不重启就连续装一串包
Wonderful Launcher 能帮你什么
这类问题麻烦的地方，不只是“少了一个 transformers”，而是你往往已经搞不清 到底是谁在启动 ComfyUI、traceback 究竟来自核心还是插件。 Wonderful Launcher 的价值就在于把这个环境边界保持清晰。
相关文档
- 逐个修复 ComfyUI Portable 依赖损坏
- ComfyUI 提示 No module named 'torch'
- comfyui-frontend-package not installed
- ComfyUI 启动失败
- 插件缺少模块时，什么时候可以先忽略
参考来源
先按上面的步驟定位根因。还卡住时，可以下载 Wonderful Launcher 检查目前机器；启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。
下载 Wonderful Launcher查看 credits 方案这篇文件解決了你的問题嗎？
你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。
ComfyUI ModuleNotFoundError: No module named 'torch' 修复
修复 ComfyUI 便携版、venv 和托管安装中的 ModuleNotFoundError: No module named 'torch'，并验证修复后的 Torch 构建仍然支持 CUDA。
ModuleNotFoundError: No module named 'onnx' 或 'onnxruntime'（ComfyUI）
修复 ComfyUI 中 ModuleNotFoundError: No module named 'onnx' 或 'onnxruntime'，涵盖 onnxruntime.capi、WanVideoWrapper FantasyPortrait、DWPose、ReActor、IPAdapter FaceID、InstantID 及 PuLID 工作流。