note: This error originates from a subprocess, and is likely not a problem with pip. error: legacy-install-failure × Encountered error while trying to install package. ╰─> pillow note: This is an issue with the package mentioned above, not pip. hint: Se

### 解决 `pip` 安装 Pillow 时出现的 `legacy-install-failure` 错误 当尝试通过 `pip` 安装某些包（如 Pillow）时，可能会遇到类似于 `legacy-install-failure` 的错误。这种错误通常表明该软件包无法按照现代标准完成安装过程，可能涉及旧版构建工具或不兼容的依赖项。 以下是针对此问题的具体分析和解决方案： #### 可能原因 1. **过时的构建工具** 如果系统的开发工具链较老，则可能导致编译阶段出现问题[^1]。 2. **Python 版本冲突** 部分库可能未完全适配最新版本的 Python 或者其内部使用的模块已弃用，例如 `distutils` 被标记为废弃并计划在未来移除[^3]。 3. **Pip 工具本身的问题** Pip 在处理一些复杂项目时会调用子进程执行特定任务；如果这些外部命令失败，最终表现为 pip 抛出异常提示[^2]。 4. **缺少必要的系统级依赖关系** 像 PIL/Pillow 这样的图像处理库往往需要链接到低层图形库 (比如 libjpeg)，如果没有预先准备好相应的头文件与共享对象，那么即使下载源码也无法顺利完成组装工作。 #### 推荐方案 ##### 方法一：升级相关组件至最新稳定状态 确保所运行的操作环境中各个组成部分均为当前推荐发行版可以有效减少因版本差异引发的各种矛盾现象。具体操作如下所示: ```bash sudo apt-get update && sudo apt-get upgrade -y python3 -m pip install --upgrade pip setuptools wheel ``` 上述指令分别实现了更新APT索引缓存、全局提升所有可选程序包以及刷新PyPI客户端及其辅助插件的目的。 ##### 方法二：提供必需的硬件支持资源 对于那些依赖于本地C/C++扩展实现高性能运算功能的应用来说，在正式部署前还需要额外配置好一系列基础框架条件才行。以Linux为例演示如何满足LXML所需的先决要素之一——XML解析器的支持情况： ```bash sudo apt-get install -y build-essential python3-dev \ libxml2-dev libxslt1-dev zlib1g-dev pip install lxml ``` 这里列举了几种常见的GNU/Linux发行平台下必备的基础建设清单供参考使用。 ##### 方法三：切换镜像站点获取更稳定的资产副本 有时候官方默认仓库由于网络波动或者其他不可抗力因素造成访问困难从而间接影响到了整个流程进度条推进速度变慢甚至停滞不前的地步。此时可以通过指定国内加速地址来改善现状效果显著： ```bash pip install pillow -i https://pypi.tuna.tsinghua.edu.cn/simple/ ``` 或者设置成永久生效模式以便日后无需重复劳动节省时间成本： ```ini [global] index-url = http://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com ``` 将以上内容保存至用户家目录下的`.pip/pip.conf` 文件当中即可长期享受便捷服务体验[^4]。 ##### 方法四：采用预编译二进制形式代替纯文本方式发布的产品形态 考虑到部分开发者并不具备足够的专业知识去自行定制化修改原始代码结构适应不同场景需求的时候可以选择直接利用别人已经制作好的成品直接拿来即用省去了繁琐的手动调整环节大大降低了入门门槛难度系数。例如Matplotlib中的Basemap工具集就提供了多种途径让用户能够轻松快速地上手实践探索地理空间数据可视化魅力所在: ```bash conda create -n myenv python=3.9 matplotlib basemap source activate myenv ``` 当然也可以借助Anaconda/Miniconda这样的科学计算生态系统一站式搞定几乎所有常见难题困扰不再担忧兼容性方面带来的麻烦事儿啦！ --- ### 总结 综上所述，面对诸如"Pillow legacy-install-failure"之类的棘手状况我们应当冷静分析背后隐藏的真实诱因然后针对性采取措施逐一排除障碍直至恢复正常运作秩序为止。希望本文介绍的方法论可以帮助大家顺利渡过难关继续前行道路上勇往直前不断创造新的辉煌成就吧！