Python处理音频元数据需区分格式：MP3必须用ID3实例显式操作帧（如TIT2）、指定UTF-8编码并保存为v2.3/v2.4；WAV需手动解析RIFF的LIST/INFO块，字段值用UTF-16-le编码且长度偶数；中文路径和标签须统一UTF-8处理，验证须用ffprobe或mediainfo交叉核对。
Python 读写音频元数据不能靠 mutagen 一把梭——MP3 和 WAV 的底层结构差异太大，强行统一接口容易写错字段、丢数据，甚至破坏文件可播放性。
MP3 元数据必须用 ID3 标准操作，别碰 EasyID3 自动映射
EasyID3 看似省事，但它把 artist 映射到 TPE1、title 映射到 TIT2，一旦你手动设了 TXXX（自定义帧）或写了非标准编码的值，EasyID3 下次读取会直接跳过或报 ID3NoHeaderError。真要稳定写入，得直操作 ID3 实例：
- 用
ID3(file_path)加载，不是EasyID3(file_path) - 写入时显式指定帧类型：比如
id3.add(TIT2(encoding=3, text="新标题"))，encoding=3表示 UTF-8（MP3 v2.4 默认） - 删除旧帧再写新值，避免残留：
if id3.get("TIT2"): del id3["TIT2"] - 保存前务必调用
id3.save(v2_version=3)或v2_version=4，否则可能写成 v2.2 帧，某些播放器不认
WAV 元数据只能靠 chunk + struct 手动解析，mutagen 基本无效
mutagen 对 WAV 的支持极弱，File("xxx.wav").info 可能返回空，tags 属性基本不可写。WAV 是 RIFF 容器，元数据藏在 LIST chunk 里的 INFO 子块中，字段名如 INAM（标题）、IALB（专辑），每个字段是 KEY<p><code>mutagen 对 WAV 的支持极弱，File("xxx.wav").info 可能返回空，tags 属性基本不可写。WAV 是 RIFF 容器，元数据藏在 LIST chunk 里的 INFO 子块中，字段名如 INAM（标题）、IALB（专辑），每个字段是 KEY\0value\0 的 null-separated 结构。实操要点：
mutagen 对 WAV 的支持极弱，File("xxx.wav").info 可能返回空，tags 属性基本不可写。WAV 是 RIFF 容器，元数据藏在 LIST chunk 里的 INFO 子块中，字段名如 INAM（标题）、IALB（专辑），每个字段是 KEY\0value\0 的 null-separated 结构。实操要点：
- 用
open(file, "rb")读原始字节，定位到b"LIST"chunk，再找其后b"INFO" - 字段值长度必须为偶数（WAV 要求 word-aligned），不足补
\0；写入前先删掉整个INFOchunk，再重建，避免偏移错乱 - 别依赖
wave模块——它只处理音频数据，完全忽略元数据 - 若需批量处理，建议用
pydub+mutagen组合：先用pydub导出为 MP3 再改标签，比硬啃 WAV chunk 更可靠
中文路径/中文标签必须显式声明编码，Windows 上尤其危险
Windows 默认 ANSI 编码（如 GBK），但 mutagen 内部一律按 UTF-8 处理字节流。如果传入的文件路径含中文，或标签值是中文字符串却没指定 encoding，会出现 UnicodeEncodeError: 'gbk' codec can't encode character 或静默写入乱码。
立即学习“Python免费学习笔记（深入）”；
- 打开文件时强制用 UTF-8 路径：
file_path.encode("utf-8").decode("utf-8")（绕过系统默认编码） - MP3 写入时所有文本帧必须带
encoding=3（UTF-8） - WAV 手动写
INFO时，中文字符串先.encode("utf-16-le")（WAV INFO 块常用 UTF-16 little-endian），再拼进字节流 - 测试务必在干净 Windows 虚拟机里跑，别只信 macOS/Linux 终端输出
真正麻烦的不是“怎么写”，而是“怎么验证写对了”——很多工具（包括 Windows 文件属性页）只读部分字段，且缓存严重。改完后要用 ffprobe -v quiet -show_entries format_tags=artist,title xxx.mp3 或 mediainfo --Inform="General;%Artist%,%Title%" xxx.wav 交叉核对，否则你以为写进了，其实还在内存里打转。
