安装wagtailtrans时出现Pillow依赖相关报错该如何解决

报错详情 #

安装wagtailtrans时触发如下报错：

Moving to c:
\users\hp\appdata\local\programs\python\python39\lib\site-packages\pil\
from C: 
\Users\hp\AppData\Local\Programs\Python\Python39\Lib\site-packages\~il
Moving to c:
\users\hp\appdata\local\programs\python\python39\lib\site-packages\pillow-8.3.2.dist-info\
from C:
\Users\hp\AppData\Local\Programs\Python\Python39\Lib\site-packages\~illow-8.3.2.dist-info
ERROR: Command errored out with exit status 1:
'c:\users\hp\appdata\local\programs\python\python39\python.exe' - u - c 'import io, os, sys, setuptools, tokenize; sys.argv[0] = '"'"'C:\\Users\\hp\\AppData\\Local\\Temp\\pip-install-r132d9vs\\pillow_2201a7b052fc4b8aa3f08901eaf540e4\\setup.py'"'"'; __file__='"'"'C:\\Users\\hp\\AppData\\Local\\Temp\\pip-install-r132d9vs\\pillow_2201a7b052fc4b8aa3f08901eaf540e4\\setup.py'"'"';f = getattr(tokenize, '"'"'open'"'"', open)(__file__) if os.path.exists(__file__) else io.StringIO('"'"'from
            setuptools import setup
            setup()'"'"');code = f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' install - -record 'C:\Users\hp\AppData\Local\Temp\pip-record-ll058sa9\install-record.txt' - -single-version-externally-managed - -compile - -install-headers 'c:\users\hp\appdata\local\programs\python\python39\Include\Pillow' Check the logs for full command output.

报错翻译 #

正在将文件从 C:\Users\hp\AppData\Local\Programs\Python\Python39\Lib\site-packages\~il 移动到 c:\users\hp\appdata\local\programs\python\python39\lib\site-packages\pil\
正在将文件从 C:\Users\hp\AppData\Local\Programs\Python\Python39\Lib\site-packages\~illow-8.3.2.dist-info 移动到 c:\users\hp\appdata\local\programs\python\python39\lib\site-packages\pillow-8.3.2.dist-info\
错误：命令执行失败，退出状态码1：
（以下为pip执行的Pillow安装命令详情）可查看日志获取完整命令输出。

根本原因 #

该报错由wagtailtrans依赖的Pillow 8.3.2版本编译安装失败导致：

1. Pillow 8.3.2未完全适配Windows环境下的Python 3.9版本，本地编译时会触发路径处理异常
2. 日志中出现的~il、~illow前缀的临时目录是安装失败后残留的未完成安装文件，会进一步阻塞后续Pillow相关的安装操作

解决步骤 #

• 先卸载残留的不完整Pillow安装包，清理pip缓存：

pip uninstall -y pillow
pip cache purge

• 安装适配Python 3.9的高版本Pillow，直接拉取预编译二进制包跳过本地编译：

pip install --only-binary :all: pillow>=9.1.0

• 最后安装兼容高版本Pillow的wagtailtrans：

pip install wagtailtrans>=2.2.1

执行完以上步骤即可完成安装，不会再触发Pillow编译报错。

内容的提问来源于stack exchange，提问作者Ranjitha Sanker