透明PNG粘贴PDF/图片后出现黑色背景的问题排查与修复咨询

问题根源 #

你遇到的黑色背景问题，核心是PIL的paste()方法默认不会处理PNG的alpha透明通道。直接调用initial.paste(p)时，PIL会把PNG的透明区域替换成默认的黑色背景，不管粘贴到普通图片还是PDF上都会出现这个问题。

修复方案 #

粘贴时必须传入源PNG的alpha通道作为遮罩（mask），让PIL根据透明度信息混合图层，保留透明效果。修改paste()方法的调用即可：

initial.paste(p, mask=p)

如果PNG图片模式不是RGBA（比如被转换过），最好提前确保源图片包含alpha通道：

p = p.convert("RGBA")

修改后的完整代码 #

import sys
from PIL import Image, ImageOps

def main():
    def paster(inp, output):
        shirt = Image.open('shirt.png').convert("RGBA")  # 确保shirt是RGBA模式
        initial = Image.open(inp).convert("RGBA")  # 目标图片转RGBA避免模式不兼容
        size = initial.size
        p = ImageOps.fit(shirt, size, method=Image.BICUBIC, bleed=0.0, centering=(0.5, 0.5))
        # 粘贴时传入alpha通道作为遮罩
        initial.paste(p, mask=p)
        # 根据输出格式调整保存逻辑
        if output.lower().endswith('.pdf'):
            initial.save(output, "PDF", resolution=100.0)
        else:
            # 非透明格式转RGB后保存，避免异常
            initial.convert("RGB").save(output)

    if len(sys.argv) < 3:
        sys.exit('Too few command-line arguments')
    elif len(sys.argv) > 3:
        sys.exit('Too many command-line arguments')
    else:
       paster(sys.argv[1], sys.argv[2])

if __name__ == '__main__':
    main()

额外说明 #

• 目标图片转成RGBA模式，可避免因图片模式不兼容导致的异常。
• 保存时如果是PDF，直接保存RGBA模式图片即可；如果是JPG这类不支持透明的格式，需先转成RGB，否则透明区域会被自动填充为黑色或白色。

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