Stable-Diffusion-WebUI安装失败：CLIP组件安装报‘ModuleNotFoundError: No module named 'pkg_resources'’错误求助
2026-4-27
解决Stable-Diffusion-WebUI中CLIP组件安装失败的方案
我来帮你搞定这个CLIP安装卡壳的问题——这个ModuleNotFoundError: No module named 'pkg_resources'报错根源很明确：pkg_resources是Pythonsetuptools包的核心组件，要么是你的setuptools没安装、版本过低，要么是环境依赖出现了损坏。结合你的Win11+Python3.10.6+RTX3090环境，我整理了几个针对性的修复步骤：
第一步：更新pip和setuptools到最新版本
打开CMD或者PowerShell，先激活你的Python3.10.6环境（如果使用了虚拟环境的话），然后执行以下命令：
python -m pip install --upgrade pip setuptools wheel
这一步能把基础工具更新到兼容Python3.10的稳定版本，修复大部分依赖损坏的问题。
第二步：手动安装CLIP依赖
有时候WebUI的自动安装脚本会忽略一些细节，咱们先手动处理CLIP的依赖：
- 下载报错中提到的CLIP源码包并解压到本地任意文件夹
- 打开命令行进入解压后的CLIP文件夹，执行：
pip install -e .
如果仍然报pkg_resources相关错误，就额外安装一个和Python3.10适配性良好的setuptools版本：
pip install setuptools==65.5.0
这个版本经过验证，和Python3.10兼容性拉满，不会出现版本冲突问题。
第三步：清理并重建WebUI的虚拟环境
WebUI默认会创建venv虚拟环境，如果这个环境里的依赖混乱，就容易出问题：
- 找到WebUI文件夹中的
venv文件夹，直接删除 - 先执行第一步的更新命令，再重新运行
webui.bat，让脚本重新创建一个干净的虚拟环境
第四步：检查CUDA相关依赖
你使用的是CUDA13.1，但目前PyTorch对cu118的支持更稳定（完全兼容RTX3090），可以先确保环境中的PyTorch是适配版本：
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
如果以上步骤都尝试后还是不行，你可以在运行WebUI时添加强制重装参数，让脚本彻底重新安装所有依赖：
webui.bat --reinstall-packages
内容的提问来源于stack exchange，提问作者Zaffer
