提示缺少 yaml、PIL 或 pydantic_settings：先核对包名，不要照抄报错安装

先回答最容易弄错的一步

报错里写的是 Python 要导入的名字，不保证就是 pip 安装时使用的名字。这里的对应关系是 yaml → PyYAML、PIL → Pillow、pydantic_settings → pydantic-settings。包名与导入名并非一一同名，依据分别见 PyPA、Pillow、PyYAML 和 Pydantic 官方资料。1234

按 traceback 中的模块逐一检查

先找到启动报错 ComfyUI 实例的实际解释器。教程中的 python 必须指向该解释器，不能默认是终端 PATH 上的系统 Python。如果报错指向 yaml，先查对应分发包，再用同一解释器试导入：

python -m pip show PyYAML
python -c "import yaml; print(yaml.__file__)"

若报错指向 PIL，将上述检查分别换成 Pillow 和 PIL；若指向 pydantic_settings，则换成 pydantic-settings 和 pydantic_settings。只检查 traceback 中真正缺失的模块。pip show 提供分发包记录，导入测试才检查当前解释器能否加载模块。缺少分发包时，先看报错所属节点的依赖约束再选择兼容版本；若包已安装却仍无法导入，先比对安装位置、实际解释器和完整 traceback。

错误变了，应换分支

如果原来是 No module named，处理后变成配置字段验证失败，就已经不是同一个阶段。不要继续反复安装。若文件名恰好叫 yaml.py 或 PIL.py，把它作为可能遮挡真实包的调查线索，先记录来源，不直接删除别人的代码。

怎样确认这一轮有效

每次只做一项相关改动，保留改动前后的包信息，重启原实例，复现刚才的节点加载。验收分别记录“模块可导入”“节点已注册”“原任务成功”，不要把终端出现安装成功当作出图成功。本文没有给任何节点锁定统一版本，也不提供从错误名自动安装未知包的脚本。

相关排查

• ComfyUI 教程里的命令该粘到哪里？PowerShell、CMD、虚拟环境分开看
• 修复 ComfyUI 前后该记什么：一份可复查的环境记录

资料与语言审查日期：2026-09-26。本站未实际安装包、复现 ComfyUI 导入失败或进行 GPU 测试。