使用PIL粘贴裁剪图片至另一张图片时触发ValueError问题排查

你遇到的这个错误是因为对PIL的Image.paste()方法使用有误，核心问题有两个：

1. paste()的参数类型错误 #

Image.paste()的第一个参数需要传入Image对象，而不是图片文件的路径字符串。你代码里传的"head.jpg"是字符串，PIL无法将其识别为可粘贴的图像内容，自然没法确定区域大小，从而触发了ValueError。

2. 链式调用逻辑错误 #

body.paste()方法本身没有返回值（返回None），所以你不能直接在它后面链式调用.save("out.jpg")——这相当于对None调用save()，即使前面的粘贴操作没问题，这里也会报错。

修正后的简洁代码 #

其实你完全不需要把裁剪后的头像保存成文件再读取，直接使用裁剪得到的Image对象即可，既简洁又能避免不必要的磁盘操作：

from PIL import Image

# 打开两张原始图片
body = Image.open("1.jpg")
head = Image.open("2.jpg")

# 定义头像裁剪区域
headbox = (0, 0, 30, 30)
# 裁剪头像，直接得到Image对象
cropped_head = head.crop(headbox)

# 将裁剪后的头像粘贴到目标图指定位置
body.paste(cropped_head, (0, 0))
# 单独保存最终结果
body.save("out.jpg")

备选方案（如果需要先保存裁剪图） #

如果你确实需要先保存裁剪后的头像文件，那也得重新打开这个文件得到Image对象后再传入paste：

from PIL import Image

body = Image.open("1.jpg")
head = Image.open("2.jpg")

headbox = (0, 0, 30, 30)
# 保存裁剪后的头像
head.crop(headbox).save("head.jpg")
# 重新打开得到Image对象
cropped_head = Image.open("head.jpg")

body.paste(cropped_head, (0, 0))
body.save("out.jpg")

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