AIFF格式要求整数采样、大端字节序、严格块对齐：float32须线性映射并钳位至int16/int32范围，逐样本字节序翻转；文件头需手动构造FORM/AIFF/COMM/SSND结构，所有整数字段大端写入，且必须用二进制模式打开文件避免换行符污染。
AIFF格式核心约束：必须是整数采样，且需严格对齐字节序与块边界
AIFF（Audio Interchange File Format）不是容器格式，它要求原始采样数据为 int16_t 或 int32_t（不支持 float），且整个文件结构依赖大端字节序（Big-Endian）。如果你手头是 float32 PCM 数据（比如从 Web Audio、librosa 或音频处理 pipeline 得到的归一化 [-1.0, 1.0] 样本），直接写入会得到静音或严重失真——因为 AIFF 解码器会把 IEEE 754 浮点位模式当做大端整数解释。
实操建议：
- 先将
float32样本线性映射到目标整型范围：int16_t对应 [-32768, 32767]，int32_t对应 [-2147483648, 2147483647]；注意用std::clamp防溢出，别用简单截断（C-style cast） - 转换后必须逐样本做字节序翻转：x86/ARM 是小端，而 AIFF 要求大端。可用
htons()/htonl()，或std::byteswap（C++23） - 采样率、声道数、位深度必须在文件头中精确声明，且后续数据块长度（
SSNDchunk 的offset和blockSize）要对齐：AIFF 规定blockSize恒为 0（无填充），offset恒为 0，但字段仍需写入
手动构造 AIFF 文件头：绕过 libsndfile 等库的必要场景
多数项目用 libsndfile 即可导出 AIFF，但当你需要零依赖、嵌入式环境、或需精确控制 chunk 顺序（例如插入自定义 INST 或 MARK chunk）时，就得手写 header。AIFF 是 IFF 变种，主结构是 FORM chunk 包裹 AIFF type 和若干子 chunk（COMM, SSND）。
关键字段写法（以 stereo 44.1kHz int16 为例）：
立即学习“C++免费学习笔记（深入）”；
FORM<4-byte size> AIFF COMM<18> <numChannels=2> <numSampleFrames=XXXXXX> <sampleSize=16> <sampleRate=0x40426000 (big-endian 44100.0)> SSND<4-byte size> <offset=0> <blockSize=0> <raw int16 data...>
注意：FORM 后的总尺寸是整个文件长度减 8（即不含 "FORM" 和其后 4 字节 size 字段）；COMM chunk 固定 18 字节；SSND 的 size 字段 = 原始采样字节数 + 8（因含 offset/blockSize）；所有整数字段必须用大端写入。
避免 std::ofstream::write 默认行为导致的换行符污染
用 C++ 写二进制文件时，若打开 std::ofstream 未指定 std::ios::binary，在 Windows 下可能把 \n 自动转成 \r\n，破坏 AIFF 的固定偏移布局，导致播放器读取失败或报错 "Invalid AIFF file: SSND chunk not found"。
正确写法：
std::ofstream file("out.aiff", std::ios::binary);
if (!file.is_open()) { /* handle error */ }
file.write(reinterpret_cast<const char*>(&form_chunk), 8); // FORM + size
// ... 其他 header 字段
file.write(reinterpret_cast<const char*>(int16_data_be), total_bytes);
file.close();常见错误：
- 用
file << "FORM"—— 这是文本流操作，会触发 locale 相关转换 - 忘记
std::ios::binary标志，尤其在跨平台构建时容易遗漏 - header 结构体未用
#pragma pack(1)或[[gnu::packed]]对齐，导致编译器插入 padding 字节，使实际写入尺寸与预期不符
验证生成结果是否真正合规：不止于能播放
能被 QuickTime 或 VLC 播放 ≠ 是合法 AIFF。很多播放器有容错逻辑，会跳过错误 header 字段继续解码，掩盖底层问题。真正验证需检查：
- 用
xxd out.aiff | head -20确认前 4 字节是46 4f 52 4d（"FORM" ASCII），第 9–12 字节是41 49 46 46（"AIFF"） - 用
afinfo out.aiff（macOS）或soxi out.aiff（Linux/macOS）输出采样率、位深、声道数是否与你写入的COMMchunk 一致 - 用 Audacity 打开后查看“轨道信息”：若显示 “16-bit signed integer (AIFF)” 而非 “32-bit float (AIFF)” 或乱码，说明整型转换和字节序正确
最容易被忽略的是 sampleRate 字段的 IEEE 754 表示——它不是整数，而是 10-byte extended precision float（AIFF spec 强制要求），但实际中绝大多数工具接受 4-byte big-endian int32 作为简化实现（如 libsndfile）。若你追求 100% 合规，得手动生成那个 10 字节浮点格式，否则用 4 字节也基本兼容。
