WAV文件必须补全44字节RIFF头和fmt子块，PCM数据需严格匹配AudioFormat参数（采样率、位深、声道数、小端序），subChunk2Size须等于PCM字节数并确保偶数对齐，否则播放器无法识别。
PCM数据写入WAV文件前必须补全RIFF头和fmt子块
WAV不是裸PCM容器，直接把byte[]写进文件会导致播放器无法识别。必须手动构造WAV文件头：44字节标准头（含"RIFF"、"WAVE"、"fmt "、"data"等标识），否则用AudioSystem.write()会失败或生成损坏文件。
-
AudioFormat中采样率、位深、声道数必须与实际PCM数据严格一致，否则头里写的avgBytesPerSec和subChunk2Size会错位 - 16位PCM需按小端序（little-endian）排列，Java默认
DataOutputStream是大端，得用ByteBuffer.order(ByteOrder.LITTLE_ENDIAN) - 单声道、双声道的
frameSize不同（如16bit单声道=2字节/帧，双声道=4字节/帧），影响subChunk2Size计算
用AudioSystem.write()写WAV最简但限制多
如果已有AudioInputStream，AudioSystem.write()能自动补头，但前提是输入流的AudioFormat必须被JDK原生支持（如LINEAR、PCM、ALAW、ULAW）。常见踩坑点：
- 传入
AudioFormat时设encoding = AudioFormat.Encoding.PCM_SIGNED，不能用PCM_UNSIGNED（JDK不支持） - 采样率必须是整数，且推荐用44100、48000、16000等常见值；用44100.5会抛
IllegalArgumentException - 位深必须是8、16、24、32之一；传20会静默转成16，导致数据截断
- 文件后缀必须为
".wav"，用".WAV"在Windows下可能失败
AudioFormat format = new AudioFormat(
AudioFormat.Encoding.PCM_SIGNED,
44100.0f, // sampleRate
16, // sampleSizeInBits
2, // channels
4, // frameSize (2 bytes × 2 channels)
44100.0f, // frameRate
false // bigEndian → false for little-endian
);
ByteArrayInputStream bais = new ByteArrayInputStream(pcmBytes);
AudioInputStream ais = new AudioInputStream(bais, format, pcmBytes.length / format.getFrameSize());
AudioSystem.write(ais, AudioFileFormat.Type.WAVE, new File("out.wav"));手动写WAV头更可控，适合非标准PCM场景
当PCM来自硬件采集、网络流或自定义编码（如带静音头、非对齐buffer），必须手写头。关键字段要动态算：
-
ChunkSize = 36 + subChunk2Size（36是头固定长度，subChunk2Size = pcmBytes.length） -
SubChunk2Size必须等于原始PCM字节数，多1字节都会让播放器解码错位 - 16位双声道PCM，每帧4字节，若
pcmBytes.length不是4的倍数，需在末尾补0（否则frameSize校验失败） - 写完头再写PCM数据，顺序不能颠倒；用
FileOutputStream配合DataOutputStream逐字段写
DataOutputStream dos = new DataOutputStream(new FileOutputStream("out.wav"));
// RIFF header
dos.writeBytes("RIFF");
dos.writeInt(36 + pcmBytes.length); // ChunkSize
dos.writeBytes("WAVE");
// fmt subchunk
dos.writeBytes("fmt ");
dos.writeInt(16); // SubChunk1Size
dos.writeShort((short) 1); // AudioFormat (1 = PCM)
dos.writeShort((short) channels);
dos.writeInt((int) sampleRate);
dos.writeInt((int) (sampleRate * channels * bitsPerSample / 8)); // byteRate
dos.writeShort((short) (channels * bitsPerSample / 8)); // blockAlign
dos.writeShort((short) bitsPerSample);
// data subchunk
dos.writeBytes("data");
dos.writeInt(pcmBytes.length);
dos.write(pcmBytes);
dos.close();注意字节序、padding和异常边界
真实项目里最容易漏的是字节对齐和异常处理：
立即学习“Java免费学习笔记（深入）”；
- WAV规范要求
data子块大小必须是偶数，若pcmBytes.length为奇数，得在末尾补1个0x00字节，并同步更新SubChunk2Size和ChunkSize - 写磁盘时没加
try-with-resources或close()，会导致文件句柄泄露，多次调用后FileNotFoundException报“Access is denied” - 从麦克风实时采集PCM时，buffer可能含静音帧或未填满部分，直接写入会导致杂音，应先用
Arrays.copyOfRange()截取有效长度 - Android上
AudioRecord返回的PCM默认是小端，但某些芯片（如部分高通平台）可能反直觉地返回大端，需实测验证
手写WAV头不难，难在每个字段都得跟PCM数据严丝合缝。尤其subChunk2Size和字节序，错一个就整个文件打不开——建议先用Audacity打开生成的WAV，看是否能正确显示波形和采样率，比听声音更早发现问题。
