PlaySound 是 Windows 上最轻量的 WAV 播放方案，仅需链接 winmm.lib、传入 PCM 编码 WAV 绝对路径，并用 SND_FILENAME | SND_ASYNC 标志；不支持中文路径、ADPCM 或损坏文件头，跨平台需 miniaudio 等库。
Windows 上用 PlaySound 快速播 WAV 提示音
直接调用系统 API 播放提示音，PlaySound 是最轻量、无需额外依赖的选择，但只支持 WAV 格式（且必须是 PCM 编码，不支持 ADPCM 等压缩格式）。
常见错误是传入路径含中文或相对路径没解析对，导致静音无报错；另一个坑是忘记链接 winmm.lib，编译时会报 LNK2019: unresolved external symbol PlaySoundA。
- 在 VS 项目属性 → 链接器 → 输入 → 附加依赖项里加
winmm.lib - 路径必须是绝对路径或确保当前工作目录正确，推荐用
GetModuleFileName+ 目录拼接 - 第三个参数传
SND_FILENAME | SND_ASYNC：异步播放不阻塞主线程；若要等播完再继续，改用SND_SYNC - 如果 WAV 文件头损坏或采样率/位深不被 Windows 原生支持（如 32-bit float），
PlaySound会静默失败，建议先用音频工具另存为「PCM, 16-bit, 44100Hz, Mono/Stereo」
#include <windows.h>
#include <string>
void playWav(const std::string& path) {
if (PlaySoundA(path.c_str(), nullptr, SND_FILENAME | SND_ASYNC | SND_NODEFAULT)) {
// 成功
} else {
// 失败：检查 path 是否可读、是否真为 PCM WAV
}
}
Linux/macOS 下没有等价的 PlaySound，得靠 ALSA/PulseAudio/Core Audio
POSIX 系统没有统一系统级声音 API，PlaySound 是 Windows 特有。想跨平台或在 Linux/macOS 上播 WAV，必须引入外部库或系统框架。
硬写 ALSA 或 Core Audio 代码太重，实际项目中几乎没人这么做。更现实的路径是：用 libsoundio（轻量、C 接口、支持多后端）或 miniaudio（单头文件、零依赖、自带 WAV 解码）。
立即学习“C++免费学习笔记（深入）”；
-
miniaudio的ma_decoder可直接读 WAV 文件并喂给ma_device播放，50 行内搞定，且自动处理格式转换 - 不要尝试用
system("aplay xxx.wav")或afplay：无法控制播放状态、无错误反馈、进程启动开销大、路径空格和 shell 注入风险 - macOS 上
AudioToolbox/AudioServicesPlaySystemSound只能播系统自带短提示音（ID 如kSystemSoundID_VolumeUp），不能播自定义 WAV
需要解码 MP3/FLAC 或控制播放进度？别碰系统 API，上 libmpg123 + libopus + miniaudio
系统 API（包括 Windows 的 PlaySound 和 macOS 的 AudioServices）都只支持极简场景：一次性播 PCM WAV 或极短系统音效。一旦涉及解码、音量调节、暂停/seek、流式播放，就必须自己管理音频流。
这时候关键不是“怎么调系统 API”，而是“怎么选解码+输出组合”。推荐方案是：miniaudio 做设备层 + 各解码库做数据层。
- WAV：用
miniaudio内置解码器，开箱即用 - MP3：加
libmpg123，注意其默认不支持 ID3v2，需调用mpg123_open_fd或预 strip 标签 - FLAC/OGG/Opus：用
libflac/libvorbis/libopus，各自提供FLAC__stream_decoder_process_single类接口，输出 PCM 后喂给miniaudio设备 - 别自己实现 WAV header 解析——
miniaudio的ma_decoder_init_file已处理 riff/chunk 对齐、fact chunk、data offset 等所有边界情况
调试时听不到声音？优先查这三件事
音频问题最难 debug，因为失败常静默发生。与其猜，不如按顺序确认：
- 用系统自带播放器（如 Windows 的 Groove、macOS 的 QuickTime）手动打开该 WAV 文件，确认它本身能播且没静音
- 检查程序运行时的音频输出设备是否被其他应用独占（尤其 Windows 上某些游戏/会议软件会抢占 WASAPI 共享模式）
- 在代码里加日志：打印
PlaySound返回值、miniaudio的result码、解码器返回的帧数；WAV 文件头前 12 字节用十六进制看是否为"RIFF....WAVE"
系统 API 的“简单”是有代价的：它把兼容性、错误细节、格式容错全藏起来了。真正稳定播音频，得接受“必须带一个轻量音频库”这个事实。
