C++标准库不提供音频功能，std::audio不存在；需用SFML、RtAudio等第三方库实现音频播放与处理。
标准 C++ 没有 std::audio。这是个常见误解——C++ 标准库至今（C++23）不提供任何音频输入输出设施，std::audio 不存在，也不会出现在头文件里，编译器报错时看到的 std::audio 一定是拼写错误、自定义命名空间误用，或混淆了第三方库（比如 SFML、RtAudio、PortAudio）的命名风格。
为什么找不到 std::audio 头文件或定义
因为 C++ 标准从未将其纳入。ISO/IEC 14882 不定义音频 API，它只管语言机制和基础容器/算法/IO 流等通用能力。音频涉及硬件抽象、采样率控制、设备枚举、实时性保障，这些超出了标准库的设计边界。
常见错误现象：
- 写
#include <audio>或#include <stdaudio>→ 编译失败：No such file or directory - 写
std::audio::play(...)→ 编译失败：'audio' is not a member of 'std' - 在 Stack Overflow 或某博客里复制了“
std::audio示例” → 实际是作者把AudioPlayer类放在了namespace std里（非法且危险）
想播声音？得用第三方库，选哪个看场景
没有标准方案，但主流选择有明确分工：
立即学习“C++免费学习笔记（深入）”；
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 跨平台轻量播放（如提示音、WAV 文件）→ 用
SFML::Music或SFML::Sound（需链接-lsfml-audio） - 低延迟录音/播放、专业音频处理 → 用
RtAudio（C++ 接口，无依赖）或PortAudio（C 接口，更成熟） - 游戏内实时音效 + 3D 定位 →
OpenAL或FMOD（后者闭源） - 仅 Linux 命令行快速验证 → 绕过 C++，直接调
system("aplay sound.wav")（不推荐用于产品）
性能与兼容性影响：RtAudio 默认用 ALSA（Linux）、Core Audio（macOS）、WASAPI（Windows），比旧式 DirectSound 更稳定；SFML 封装较厚，启动慢几毫秒，但 API 简单。
一个最小可运行的 RtAudio 示例（Linux/macOS/Windows）
假设你已安装 RtAudio（如 brew install rtaudio 或从官网编译），以下代码打开默认输出设备并播放 440Hz 正弦波：
#include <RtAudio.h>
#include <cmath>
int main() {
RtAudio dac;
if (dac.getDeviceCount() == 0) return -1;
RtAudio::StreamParameters params = { dac.getDefaultOutputDevice(), 2, 0 };
dac.openStream(¶ms, nullptr, RTAUDIO_FLOAT32, 44100, &bufferFrames, callback, &data);
dac.startStream();
// ... 等待用户中断
dac.stopStream();
}
关键点：
-
callback是你写的函数，每毫秒被调用多次，必须填满outputBuffer，不能阻塞或分配内存 -
RTAUDIO_FLOAT32和采样率必须匹配硬件支持值，硬设 48000 而设备只支持 44100 →openStream失败 - Windows 上若用 MinGW 链接失败，大概率缺
-lole32 -lwinmm（RtAudio 文档里写了，但容易漏）
最常被忽略的复杂点：音频回调线程与主线程的同步。别在 callback 里调 std::cout、锁 mutex、new 对象——它可能每 5ms 执行一次，卡顿或崩溃会直接发生。真实项目里，用 lock-free ring buffer 传数据，而不是临时计算波形。
