如何使用Python的eyed3库对比两个MP3文件的封面？

MP3封面存储在ID3标签的APIC（Attached Picture）帧中，最可靠的对比方式是直接提取封面原始二进制内容做哈希校验，不要依赖图片描述、MIME类型等附属元数据，避免误判。

前置准备 #

先安装依赖库：
pip install eyed3

实现代码 #

核心逻辑是封装方法提取MP3主封面的哈希值，对比两个文件的哈希值即可判断封面是否存在更新：

import eyed3
import hashlib

# 关闭eyed3加载文件时输出的非必要警告日志
eyed3.log.setLevel("ERROR")

def get_mp3_main_cover_hash(file_path: str) -> str | None:
    """
    获取MP3文件主封面（专辑前封面）的SHA256哈希值
    文件无ID3标签或无主封面时返回None
    """
    audio_file = eyed3.load(file_path)
    if not audio_file or not audio_file.tag:
        return None
    
    # 遍历所有内嵌图片，匹配ID3标准定义的主封面类型（picture_type=3 为Front Cover）
    for img in audio_file.tag.images:
        if img.picture_type == 3:
            # 对封面原始二进制数据计算哈希
            return hashlib.sha256(img.data).hexdigest()
    
    return None

def is_cover_identical(file1: str, file2: str) -> bool:
    """对比两个MP3文件的主封面是否一致"""
    return get_mp3_main_cover_hash(file1) == get_mp3_main_cover_hash(file2)

# 调用示例
if __name__ == "__main__":
    local_track = "/your/local/path/demo_song.mp3"
    device_track = "/your/mp3_player/path/demo_song.mp3"
    if not is_cover_identical(local_track, device_track):
        print("封面存在更新，需要执行同步")
    else:
        print("封面无变化，跳过同步")

注意事项 #

• 如果同步逻辑需要对比所有内嵌图片（包括封底、艺人写真、内嵌歌词插图等），可以去掉picture_type == 3的筛选逻辑，将所有图片帧的二进制内容按固定排序拼接后再计算哈希，避免图片存储顺序不同导致的结果偏差
• 上述逻辑默认判定「两个文件都没有封面」为状态一致，「单个文件有封面」为状态不一致，符合同步工具的常规判断逻辑
• 不需要额外处理ID3版本差异，eyed3兼容ID3v2.2/2.3/2.4全版本标签的APIC帧读取
• 哈希计算性能足够支撑批量同步场景，哪怕是单张10MB的高清封面，SHA256计算耗时也在10毫秒以内，不会成为同步流程的性能瓶颈

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