如何在无终端的cPanel Django项目中安装Pillow

问题核心分析 #

你遇到的错误主要来自两个关键点：

• 所用pip版本过旧（9.0.1），对现代Python包的元数据处理、wheel编译支持不完善
• 可能存在requirements.txt中Pillow的写法错误，导致pip识别包名为unknown

分步解决方法 #

1. 优先升级pip版本
   旧版pip是导致安装失败的核心原因，先把pip升级到最新稳定版：

   • 在cPanel的「Python应用设置」界面找到你的虚拟环境，检查是否有直接升级pip的选项；如果没有，在requirements.txt中添加：

     pip==23.3.1
     

   • 执行安装操作完成pip升级后，再移除这一行（避免后续重复触发升级）。

2. 修正Pillow的安装配置

   • 确保requirements.txt中Pillow的写法为标准格式，不要带#egg=Pillow这类旧格式片段，比如：

     Pillow==9.5.0  # 该版本完美兼容Python3.9，稳定性高
     

   • 之前尝试的10.x版本安装失败，大概率是旧pip无法处理其新的包结构，换成9.x兼容版本更稳妥。

3. 重新执行安装
   升级pip并修正requirements.txt后，再次通过cPanel的pip安装界面执行安装，此时pip会优先下载预编译的wheel包，无需本地编译，成功率更高。

4. 备选方案：处理系统依赖缺失问题
   如果还是安装失败，可能是主机环境缺少Pillow编译所需的系统依赖（如libjpeg、zlib等）。由于你没有终端权限，可直接联系主机商，请求在服务器上安装libjpeg-devel、zlib-devel这类依赖包，之后再重新安装Pillow。

内容的提问来源于stack exchange，提问作者Fausto Fernandez