MacOS安装wordcloud报错error: legacy-install-failure求助

环境信息 #

• 系统版本：MacOS 13.0.1
• Python版本：3.8.10
• 已预装依赖：Matplotlib、Pillow、Pandas

执行命令 #

pip3 install wordcloud

报错内容 #

Jesse-Burton@MacBook-Pro-4 ~ % pip3 install wordcloud
正在收集wordcloud
使用缓存的wordcloud-1.8.2.2.tar.gz (220 kB)
准备元数据(setup.py)...完成
需求已满足：numpy>=1.6.1 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自wordcloud) (1.23.4)
需求已满足：pillow 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自wordcloud) (9.2.0)
需求已满足：matplotlib 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自wordcloud) (3.6.0)
需求已满足：python-dateutil>=2.7 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自matplotlib->wordcloud) (2.8.2)
需求已满足：cycler>=0.10 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自matplotlib->wordcloud) (0.11.0)
需求已满足：packaging>=20.0 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自matplotlib->wordcloud) (21.3)
需求已满足：fonttools>=4.22.0 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自matplotlib->wordcloud) (4.38.0)
需求已满足：contourpy>=1.0.1 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自matplotlib->wordcloud) (1.0.5)
需求已满足：pyparsing>=2.2.1 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自matplotlib->wordcloud) (3.0.9)
需求已满足：kiwisolver>=1.0.1 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自matplotlib->wordcloud) (1.4.4)
需求已满足：six>=1.5 在./.pyenv/versions/3.8.10/lib/python3.8/site-packages (来自python-dateutil>=2.7->matplotlib->wordcloud) (1.16.0)
正在安装收集到的包：wordcloud
弃用警告：wordcloud正使用传统的'setup.py install'方式安装，因为它没有'pyproject.toml'且未安装'wheel'包。pip 23.1将强制执行此行为变更，可启用'--use-pep517'选项替代。
Running setup.py install for wordcloud ... error
error: subprocess-exited-with-error

× Running setup.py install for wordcloud未成功运行。
│ 退出码: 1
╰─> [26行输出]
running install
/Users/Jesse-Burton/.pyenv/versions/3.8.10/lib/python3.8/site-packages/setuptools/command/install.py:34: SetuptoolsDeprecationWarning: setup.py install已被弃用，请使用build、pip及其他标准工具。
warnings.warn(
running build
running build_py
creating build
creating build/lib.macosx-12.6-arm64-cpython-38
creating build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/wordcloud_cli.py -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/_version.py -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/init.py -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/tokenization.py -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/wordcloud.py -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/color_from_image.py -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/main.py -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/stopwords -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
copying wordcloud/DroidSansMono.ttf -> build/lib.macosx-12.6-arm64-cpython-38/wordcloud
UPDATING build/lib.macosx-12.6-arm64-cpython-38/wordcloud/_version.py
set build/lib.macosx-12.6-arm64-cpython-38/wordcloud/_version.py to '1.8.2.2'
running build_ext
building 'wordcloud.query_integral_image' extension
creating build/temp.macosx-12.6-arm64-cpython-38
creating build/temp.macosx-12.6-arm64-cpython-38/wordcloud
clang -Wno-unused-result -Wsign-compare -Wunreachable-code -DNDEBUG -g -fwrapv -O3 -Wall -I/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include -I/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include -I/Users/Jesse-Burton/.pyenv/versions/3.8.10/include/python3.8 -c wordcloud/query_integral_image.c -o build/temp.macosx-12.6-arm64-cpython-38/wordcloud/query_integral_image.o
xcrun: 错误：无效的活动开发者路径(/Library/Developer/CommandLineTools)，在/Library/Developer/CommandLineTools/usr/bin/xcrun处找不到xcrun
error: command '/usr/bin/clang' failed with exit code 1
[输出结束]

note: 此错误源于子进程，大概率不是pip的问题。
error: legacy-install-failure

× 安装软件包时遇到错误。
╰─> wordcloud

note: 这是上述软件包的问题，与pip无关。
hint: 请查看上方的失败输出。

错误原因 #

核心问题是Xcode命令行工具未正确安装或路径无效，导致编译wordcloud的C扩展时调用clang失败。

解决步骤 #

1. 安装/修复Xcode命令行工具
   执行以下命令触发安装：

   xcode-select --install
   

   按照弹出的系统提示完成安装。如果之前已安装过但路径异常，执行重置命令：

   sudo xcode-select --reset
   

2. 验证修复结果
   执行命令检查xcrun是否正常：

   xcrun --version
   

   能正常输出版本信息即为修复成功。
3. 重新安装wordcloud
   直接重新执行安装命令：

   pip3 install wordcloud
   

   若仍出现setup.py弃用警告，可先安装wheel包再尝试：

   pip3 install wheel
   pip3 install wordcloud
   

内容的提问来源于stack exchange，提问作者Jesse-Burton Nicholson