Python wave.Wave_read 怎样读取 PCM 声道数和采样宽度

读取 WAV 文件的两个关键值，不需要手动切 RIFF 字节：用 wave.open(path, "rb") 得到 Wave_read，再调用 getnchannels() 取声道数、调用 getsampwidth() 取单个采样点的字节数。立体声通常是 2 个声道，16 位 PCM 的采样宽度是 2 字节，但代码应以文件头返回值为准。

用 Wave_read 直接取得两个字段

wave.open 的 rb 模式返回 Wave_read。下面的最小写法只读取头信息，不会把整段音频载入内存。代码中的 sampwidth 单位是字节，若要表达位深，再乘以 8。

import wave

def read_pcm_shape(path: str) -> tuple[int, int]:
    # 读取 WAV 头，不把全部帧数据读入内存
    try:
        with wave.open(path, "rb") as wav:
            channels = wav.getnchannels()
            sample_width = wav.getsampwidth()
            return channels, sample_width
    except wave.Error as exc:
        # 文件不是可识别的 WAV，或头部违反了规范
        raise ValueError(f"无法读取 WAV 头: {exc}") from exc

channels, sample_width = read_pcm_shape("speech.wav")
print(f"声道数={channels}, 采样宽度={sample_width} 字节")
print(f"每帧字节数={channels * sample_width}")

如果输出为 声道数=2, 采样宽度=2，表示每个音频帧包含左右两个采样点，总共 4 字节。这里的“帧”是同一时间点上所有声道采样的组合，不是文件中的一个字节。

getparams 怎样补齐 PCM 读取所需信息

只关心声道和宽度时，两个方法最清楚；需要记录完整头信息时，可以使用 getparams()。它返回 (nchannels, sampwidth, framerate, nframes, comptype, compname)，顺序固定，适合保存为一次读取快照。

import wave

with wave.open("speech.wav", "rb") as wav:
    params = wav.getparams()
    # namedtuple 字段比按下标读取更不容易写错
    print("声道数:", params.nchannels)
    print("采样宽度:", params.sampwidth, "字节")
    print("采样率:", params.framerate, "Hz")
    print("总帧数:", params.nframes)
    print("压缩类型:", params.comptype)

getframerate() 是采样频率，getnframes() 是音频帧数量。若要估算未压缩音频数据区的字节数，可以先算 nchannels * sampwidth 得到每帧宽度，再乘以 nframes；这只是数据区估算，不包含 RIFF 头和其他块。

声道数、采样宽度与每帧字节数的关系

最容易错的是把采样宽度写成“位”。getsampwidth() 的返回值是字节，所以 24 位 PCM 通常对应 3，而不是 24。若业务逻辑以位深判断，应显式写成 sample_width * 8，并把异常值记录出来，避免静默截断。

读取失败和格式边界怎么处理

wave 面向 WAV 容器和未压缩音频读取。官方文档列出的核心支持包括 PCM；较新的 Python 版本还支持满足条件的扩展 PCM 头，以及 IEEE 浮点 WAV。文件损坏、格式字段不符合规范或实现不支持时，接口会抛出 wave.Error。因此不要把任意扩展名为 .wav 的文件都当成可读 PCM。

如果只需要判断头信息，读完 getparams() 就可以关闭文件；如果还要读取数据，则用 readframes(n) 按帧取得 bytes，并根据前面的每帧宽度解释字节布局。需要 MP3、AAC、重采样或高级解码时，应换用专门的音频库，不能靠 Wave_read 绕过格式限制。

常见问题

getsampwidth 返回的是位深还是字节数？

返回每个采样点占用的字节数。要换算为常见的位深表达，使用 getsampwidth() * 8，但仍应结合文件格式确认。

怎样判断 WAV 是单声道还是立体声？

读取 getnchannels()：1 表示单声道，2 表示立体声；更多声道时按返回的整数处理，不要只写二分判断。

为什么读取 WAV 会抛出 wave.Error？

常见原因是文件头不符合 WAV 规范、格式不在模块支持范围内，或输入并非真正的 WAV。先保留异常信息，再决定是否交给其他解码器。