Python如何将PCM音频帧正确追加写入现有WAV文件

你当前的实现逻辑从根本上就没有完成“追加PCM到已有WAV”的目标，最终产出的WAV结构天然损坏，核心问题有三个：

• scipy.io.wavfile.write 是全量写入接口，每次调用都会从头生成完整的带RIFF文件头的WAV结构，完全不支持增量追加，你现在的代码本质是把另一个WAV文件的**全部二进制内容（包含文件头）**当成原始数据处理，不是纯PCM音频采样。
• 硬编码写入8000Hz的采样率，完全没有读取目标已有WAV的声道数、位深、采样率参数，就算数据拼接正确，参数不匹配也会导致播放错乱。
• 数据类型转换逻辑错误：把原始字节直接转成float数组写入，WAV格式要求的float类型采样值是归一化到[-1.0, 1.0]区间的数值，不是0-255范围的字节值转出来的float，格式完全不符合规范。

Python标准库的wave模块原生支持WAV格式读写，配合指针定位修改文件头的方式，可以低开销实现持续接收PCM帧后的追加写入，不需要每次全量读写整个WAV文件。

核心实现逻辑 #

• 首次打开目标WAV文件时，先读取原有音频的格式参数（采样率、声道数、位深），记录原有PCM数据的总长度，保证后续追加的PCM格式完全匹配。
• 将文件指针移动到原有PCM数据段的末尾位置，直接写入新收到的PCM帧二进制数据。
• 所有PCM写完后，回头更新WAV文件头里记录总长度的两个字段（RIFF块总长度、数据段总长度），不然媒体播放器会因为识别到的文件长度和实际内容不匹配，判定文件损坏。

可直接复用的追加工具代码 #

import wave
import numpy as np

def append_pcm_chunk_to_wav(wav_path: str, pcm_chunk: np.ndarray | bytes):
    # 读取原有WAV的格式参数
    with wave.open(wav_path, "rb") as old_wf:
        wav_params = old_wf.getparams()
        old_frame_count = old_wf.getnframes()
        sample_bytes = wav_params.sampwidth

    # 计算新写入的PCM对应的帧数，保证和原WAV位深匹配
    if isinstance(pcm_chunk, np.ndarray):
        # 如果是float类型的归一化PCM，先缩放到对应位深的整数范围
        if pcm_chunk.dtype.kind == "f":
            max_val = 2 ** (sample_bytes * 8 - 1) - 1
            pcm_chunk = (pcm_chunk * max_val).astype(f"int{sample_bytes*8}")
        pcm_bytes = pcm_chunk.tobytes()
    else:
        pcm_bytes = pcm_chunk
    new_frame_count = len(pcm_bytes) // sample_bytes
    total_frame_count = old_frame_count + new_frame_count
    total_data_len = total_frame_count * sample_bytes

    # 定位到文件尾部写入新PCM，并更新文件头长度字段
    with open(wav_path, "rb+") as wf:
        wf.seek(0, 2)  # 指针移动到文件最末尾
        wf.write(pcm_bytes)
        # 更新RIFF块长度字段（文件总长度 - 8）
        wf.seek(4)
        wf.write((total_data_len + 36).to_bytes(4, "little"))
        # 更新数据段长度字段
        wf.seek(40)
        wf.write(total_data_len.to_bytes(4, "little"))

使用注意事项 #

• 所有追加的PCM帧必须和原WAV参数严格匹配：如果原WAV是16bit、单声道、8000Hz，传入的PCM块就必须是对应位深、对应声道的原始采样数据，不能夹杂其他格式的内容。
• 如果是从零开始创建录制类WAV文件，第一次写入时可以先初始化一个带正确格式头的空WAV文件，后续每收到一帧PCM就调用上述函数追加，不需要每次重写整个文件内容。
• 不要在文件正在写入的过程中被其他进程打开播放，不然可能因为头字段还没更新完成，出现播放报错。

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