ModuleNotFoundError: No module named ‘pkg_resources

快速结论：这个报错实际由 RuntimeError: Couldn't install clip. 触发，根本原因是 pip 在 macOS Silicon 上无法正确下载并安装 OpenAI CLIP 包。优先尝试手动克隆并安装 CLIP 仓库。

问题场景

用户在 macOS Silicon (Apple M 系列芯片) 上，按照官方指南通过 brew 安装依赖后，在 stable-diffusion-webui 目录下执行 ./webui.sh。脚本自动创建 venv 并尝试安装 clip 包时失败，导致 WebUI 无法启动。

报错原文

RuntimeError: Couldn't install clip.
Command: "/Users/ghazel/projects/stable-diffusion-webui/venv/bin/python" -m pip install https://github.com/openai/CLIP/archive/d50d76daa670286dd6cacf3bcd80b5e4823fc8e1.zip --prefer-binary
Error code: 1

原因分析

可能原因：

macOS 环境下网络或 SSL 问题导致 pip 无法直接下载 GitHub 上的 zip 压缩包。
pip 在解析依赖或编译 CLIP 时遇到不兼容的路径或权限问题。
某些系统库或 build 工具（如 cmake、rust）虽然已安装，但 venv 内编译 CLIP 仍会失败。

环境排查

操作系统：macOS 26.5（或相近版本）
硬件：Apple Silicon (M 系列)
Python 版本：3.10.20（通过 Homebrew 安装）
已安装 Homebrew 包：cmake、protobuf、rust、python@3.10、git、wget
WebUI 版本：v1.10.1 (commit 82a973c0)
确认终端有稳定的网络连接，可手动访问 GitHub

解决步骤

手动克隆 CLIP 仓库：在任一目录下运行 git clone https://github.com/openai/CLIP.git。
使用 venv 的 pip 安装 CLIP：在 WebUI 项目根目录下执行 ./venv/bin/pip install ./CLIP（注意 CLIP 路径为刚克隆的本地目录）。
重新运行启动脚本：执行 ./webui.sh，此时它会检测到 CLIP 已安装，跳过该步骤并继续后续初始化。

验证方法

重新运行 ./webui.sh，观察控制台输出不再出现 RuntimeError: Couldn't install clip.，且 WebUI 界面正常启动。如果仍有其他报错（如 macOS 兼容性问题），可能需要进一步排查。

参考来源

AUTOMATIC1111/stable-diffusion-webui #17410

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

ModuleNotFoundError: No module named ‘pkg_resources