在PyCharm中配置Odoo14时出现PIL的_imaging导入错误如何解决

DevOps 小满

2026-10-5

该报错是Python的图片处理库Pillow（PIL的官方维护分支）安装异常导致，通常是版本不兼容、依赖缺失、系统自带PIL和第三方安装的Pillow冲突引发。

第一步：清理已安装的PIL/Pillow版本
如果你为Odoo配置了独立虚拟环境，先激活虚拟环境，再执行卸载命令：
```
pip3 uninstall -y PIL Pillow
```
如果你是Debian/Ubuntu系统，先卸载系统自带的python3-pil包避免冲突：
```
sudo apt remove python3-pil -y
```
第二步：安装Pillow编译依赖
缺失依赖会导致Pillow安装时缺少_imaging核心模块，对应系统执行依赖安装命令：
Debian/Ubuntu系：
```
sudo apt install libjpeg-dev zlib1g-dev libfreetype6-dev libpng-dev -y
```
CentOS/RHEL系：
```
sudo yum install libjpeg-turbo-devel zlib-devel freetype-devel libpng-devel -y
```
第三步：安装Odoo14兼容的Pillow版本
Odoo14适配Python3.8的最优Pillow版本为8.2.0，避免安装过高版本出现兼容问题：
```
pip3 install pillow==8.2.0
```
第四步：验证安装结果
命令行执行对应版本的Python，输入如下命令无报错即为安装成功：
```
from PIL import _imaging
from PIL import Image
```
第五步：确认PyCharm解释器配置
打开PyCharm的File > Settings > Project: 你的项目名称 > Python Interpreter，确认当前项目使用的Python解释器，和你安装Pillow的环境一致，且列表中已显示对应版本的Pillow。