Go go-wav 怎样把整数音频缓冲区编码成WAV

我第一次把整数 PCM 写成 WAV 时，最容易漏掉的不是 Write，而是“缓冲区格式”和“文件头什么时候完成”这两件事。go-audio/audio 的 IntBuffer 保存整数样本，go-audio/wav 的编码器则需要采样率、声道数、位深和音频格式；参数对不上，文件即使能生成，也可能被后续播放器误判。

官方文档：https://pkg.go.dev/github.com/go-audio/wav

实务上可以把它当成一次有边界的导出任务：先确认输入格式，再创建编码器，写入完整缓冲区，最后关闭编码器刷新 WAV 头部。失败时保留错误上下文并删除临时文件，不把半成品覆盖到正式路径。

先确认 IntBuffer 的格式边界

IntBuffer 的 Data 是整数样本，Format 描述采样率和声道数，SourceBitDepth 记录源位深。它们分别回答“样本是什么”“怎样解释样本”“每个样本原本有多宽”。不要只看到 []int 就自行猜成 16 位音频。

如果源缓冲区是 44.1 kHz 双声道，那么编码器至少要拿到相同的采样率和声道数。位深则要结合数据的真实范围和你的输出约定决定；不要把“整数类型”直接等同于某一个 WAV 位深。

按 PCM 参数创建 wav.Encoder

NewEncoder 接受一个可读写定位的输出对象，以及 sampleRate、bitDepth、numChans 和 audioFormat。标准 PCM 通常使用格式值 1。创建编码器前先创建临时文件，可以把失败和正式文件隔离。

package main

import (
    "fmt"
    "os"

    "github.com/go-audio/audio"
    "github.com/go-audio/wav"
)

// writeWAV 把整数 PCM 缓冲区写入临时 WAV 文件，成功后再交给调用方替换正式文件。
func writeWAV(tmpPath string, buf *audio.IntBuffer, bitDepth int) error {
    if buf == nil || buf.Format == nil {
        return fmt.Errorf("音频缓冲区或格式信息为空")
    }
    if buf.Format.SampleRate 

这里的 bitDepth 是明确的输出约定，不应悄悄从宿主机的 int 大小推断。若上游是 24 位或浮点数据，先完成有依据的量化或缩放，再交给整数编码路径；不要把转换和文件写入混在一个无法回滚的临时步骤里。

写入缓冲区后必须关闭编码器

Write 负责把 IntBuffer 交给编码器，Close 负责把尚未确定的文件头信息刷新到输出。我的经验是把这两个错误分开包装：写入失败说明数据或输出路径有问题，关闭失败则要把成品当作失败处理。

如果只想追加一个样本，也可以使用 WriteFrame；但批量的 IntBuffer 更适合一次调用 Write。无论哪种方式，都要把输出对象、编码器和最终关闭动作放在同一个错误处理边界内。

小文件导出可以在临时路径完成后再改名；跨文件系统改名、权限、磁盘空间和并发覆盖仍需由调用方负责。本文示例没有实际生成音频文件，代码中的结果描述是接口使用说明，不是本机运行回执。

失败时保留临时文件并回滚

当 Write 或 Close 返回错误时，不要继续把临时文件当成有效 WAV。最小回滚动作是关闭文件描述符、删除临时文件，并把采样率、声道数、位深、目标路径和原始错误写入控制路径。

如果输出路径已存在，建议使用“临时文件成功后替换”的策略，而不是直接覆盖正式文件。这样即使磁盘写满或编码器关闭失败，旧文件仍然可回退。对于并发导出，要为每次任务使用独立临时名，不能共享同一个 .tmp。

排障时优先区分三类信号：参数错误、写入错误和关闭错误。参数错误通常发生在打开文件前；写入错误关注样本类型、输出权限和磁盘；关闭错误则要检查文件是否被提前关闭、是否仍可定位以及底层写入是否完成。

在发布前记录可复查的格式信息

生成任务的日志不必打印每个样本，但应保留文件名、采样率、声道数、输出位深、样本数量和耗时。这样下游发现“声音变快”“左右声道错位”或文件无法打开时，可以先回看格式解释，而不是盲目重编码。

如果需要读取回写结果，另开一个 os.File 交给 wav.NewDecoder，再查看 Format、SampleBitDepth 或 IsValidFile。这是应用自己的复查动作，不要把它写成编码器必然成功的保证；大文件也不要为了方便无条件调用会把全部 PCM 放进内存的接口。

为什么写出来的 WAV 时长不对？

先查采样率、声道数和样本数量是否对应。采样率填大或填小都会改变时长解释，声道数不匹配还会让交错样本被错误拆分。

调用 Write 后还要调用 Close 吗？

要。Close 用于刷新文件头并完成编码器收尾；把它省略后，输出文件可能缺少正确的长度信息。

可以把 SourceBitDepth 当成 NewEncoder 的 bitDepth 吗？

只有在你确认输出不做位深转换时才可以这样做。若数据经过缩放、截断或重新量化，输出位深应由转换后的格式约定决定，并在记录中说明。

这套写法适合批量音频导出、缓存 PCM 和离线转码的 Go 程序：先固定格式边界，再写临时文件，最后用关闭结果决定是否替换正式文件。