ModuleNotFoundError: No module named ‘pkg_resources’

快速结论：该报错通常出现在 macOS（Apple Silicon）上执行 ./webui.sh 初始化环境时，WebUI 在自动安装 OpenAI CLIP 依赖的步骤失败，从而抛出 RuntimeError: Couldn't install clip.。优先排查 CLIP 是否能被当前 venv 正常安装，而不是先怀疑模型或显卡。

适用环境：Issue 中确认的场景为 Mac Silicon、macOS 26.5、Python 3.10.20，WebUI 版本 v1.10.1（commit 82a973c04367123ae98bd9abdf80d9eda9b910e2），使用全新 clone 后通过 ./webui.sh 启动。

最快修复方案：Issue 中给出并验证可行的 workaround 是：先手动 clone OpenAI CLIP 仓库，再用 WebUI 自带的 venv pip 从本地目录安装 CLIP，然后重新运行 ./webui.sh；此时脚本会跳过 CLIP 安装步骤。

注意事项：该方案属于 workaround，不是上游代码修复；它只绕过自动安装失败，不能保证后续其他依赖也会顺利安装。Issue 评论中有人指出 macOS 上还可能存在其他兼容问题，因此修复 CLIP 后仍需观察是否能完整启动 WebUI。

问题场景

用户在 macOS（Mac Silicon）上按照官方 Apple Silicon 安装流程，先通过 Homebrew 安装 cmake protobuf rust python@3.10 git wget，然后 clone stable-diffusion-webui 仓库，并运行 ./webui.sh。脚本创建 Python venv 后自动下载并安装依赖，在“Installing clip”阶段失败，导致 WebUI 无法继续启动。

报错原文

Installing clip
Traceback (most recent call last):
  File "/Users/ghazel/projects/stable-diffusion-webui/launch.py", line 48, in <module>
    main()
  File "/Users/ghazel/projects/stable-diffusion-webui/launch.py", line 39, in main
    prepare_environment()
  File "/Users/ghazel/projects/stable-diffusion-webui/modules/launch_utils.py", line 394, in prepare_environment
    run_pip(f"install {clip_package}", "clip")
  File "/Users/ghazel/projects/stable-diffusion-webui/modules/launch_utils.py", line 144, in run_pip
    return run(f'"{python}" -m pip {command} --prefer-binary{index_url_line}', desc=f"Installing {desc}", errdesc=f"Couldn't install {desc}", live=live)
  File "/Users/ghazel/projects/stable-diffusion-webui/modules/launch_utils.py", line 116, in run
    raise RuntimeError("\n".join(error_bits))
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

评论摘要中还提到核心英文报错：ModuleNotFoundError: No module named 'pkg_resources'。

原因分析

WebUI 在 prepare_environment() 阶段会通过 pip 从 GitHub 下载 CLIP 的 zip 包并安装。当前环境中该安装过程返回错误码 1，导致 run_pip() 抛出 RuntimeError: Couldn't install clip.。从评论信息看，底层可能还伴随 ModuleNotFoundError: No module named 'pkg_resources'，这通常与 setuptools/pkg_resources 在 venv 中不可用或安装过程被中断有关。具体根因需要结合完整 pip 输出确认，Issue 中未给出完整的 pip 错误堆栈。

环境排查

确认系统：Mac Silicon、macOS 26.5。
确认 Python：Python 3.10.20。
确认 WebUI：v1.10.1，commit 82a973c04367123ae98bd9abdf80d9eda9b910e2。
确认是否在全新 clone 的 WebUI 目录下操作。
确认是否使用 WebUI 自己创建的 venv：stable-diffusion-webui/venv/bin/python。
检查 venv 中 pip 是否可正常安装包，以及 pkg_resources 是否可用。
如果手动安装过 setuptools，确认安装到了 WebUI 的 venv 中，而不是系统 Python 或其他虚拟环境。

解决步骤

手动 clone OpenAI CLIP 仓库：

git clone https://github.com/openai/CLIP.git
使用 WebUI venv 中的 pip 从本地 clone 目录安装 CLIP。根据 Issue 评论中的写法：

./stable-diffusion-webui/venv/bin/pip install ./CLIP
确认安装成功后，重新运行 WebUI 启动脚本：

./webui.sh
此时脚本应检测到 CLIP 已安装，从而跳过“Installing clip”步骤，继续后续初始化。

如果上述步骤仍失败，可优先尝试确认 venv 内是否缺少 setuptools 或 pkg_resources，但 Issue 中没有给出该方向的已验证完整命令，因此只能作为排查方向。

验证方法

重新运行 ./webui.sh 后，不再出现 RuntimeError: Couldn't install clip.，并且日志不再停留在“Installing clip”阶段，而是继续完成依赖安装并尝试启动 Web UI。如果仍报错，应复查 venv 内 CLIP 是否安装成功，以及是否有新的 Python 依赖报错。