PIL设置GIF循环次数为1无效：网页端循环两次的问题求助

问题分析 #

使用PIL裁剪GIF并设置loop=1后，微软「照片」应用中仅播放一次，但HTML页面中会播放两次；设置loop=0则会无限循环——核心原因是不同解析器对GIF循环参数的理解存在差异，且PIL的loop参数定义为循环次数（而非总播放次数）：loop=1表示播放完一次完整动画后，再循环1次，总共播放2遍。若要实现仅播放一次（无循环），需避免添加循环扩展块，而非设置loop参数。

修正后的代码 #

from PIL import Image, ImageSequence
input_gif = "input.gif"
output_gif = "output.gif"

crop_box = (0, 0, 300, 500)  # (left, upper, right, lower)

with Image.open(input_gif) as gif:
    frames = []
    # 清除原始GIF的循环设置，避免新旧配置冲突
    if 'loop' in gif.info:
        del gif.info['loop']

    for frame in ImageSequence.Iterator(gif):
        cropped_frame = frame.crop(crop_box)
        frames.append(cropped_frame)

    frames[0].save(
        output_gif,
        save_all=True,
        append_images=frames[1:],
        # 不设置loop参数，让GIF不包含循环扩展块，实现仅播放一次
        duration=gif.info.get("duration", 100),
        disposal=gif.info.get("disposal", 2)  # 保留原始帧的 disposal 模式，避免画面残留
    )

print("GIF cropped and saved successfully!")

关键说明 #

• 清除原始loop信息：避免原始GIF的循环设置干扰新生成的文件
• 不设置loop参数：遵循GIF标准，无循环扩展块的GIF会被所有解析器识别为仅播放一次
• 保留disposal参数：保证帧切换时的显示效果，避免出现旧帧残留的异常

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