PlaySound仅支持WAV格式且为同步阻塞调用，易致主线程卡顿或静音；常见原因包括路径错误、窄字符串传参、资源未加载、缺失SND_FILENAME标志及SND_ASYNC与SND_LOOP误用；建议改用waveOut API或跨平台库如miniaudio以获得精确控制。
PlaySound 只能播放 WAV 文件，不支持 MP3、AAC 等格式；它本质是 Windows API 的同步阻塞调用，用错参数容易卡主线程或静音。
PlaySound 函数的基本调用和常见静音原因
最简可用写法是：PlaySound(L"sound.wav", NULL, SND_FILENAME | SND_SYNC);。但实际中常静音，原因包括：
- 路径错误：必须是绝对路径或程序当前工作目录下的相对路径，
L"res/sound.wav"若没切工作目录就无效 -
编码问题：宽字符字符串需用
L""前缀，传"sound.wav"（窄字符串）会乱码或失败 - 资源未加载：WAV 文件若被压缩（如 ZIP 内）、或权限受限（如装在 Program Files 下但无读取权），
PlaySound会静默失败，不报错 - 缺少
SND_FILENAME标志：只传文件名却不加该标志，函数会误以为是资源 ID，直接返回失败
SND_ASYNC 和 SND_LOOP 的组合陷阱
想边播边干活，自然想到 SND_ASYNC；想循环播放，加上 SND_LOOP。但这两者合用有隐藏限制：
-
SND_LOOP必须搭配SND_ASYNC，否则循环无效（同步模式下播完就退出，无法重入） - 循环播放期间不能重复调用
PlaySound同一文件，否则可能中断当前播放或引发未定义行为 - 停止循环只能靠
PlaySound(NULL, NULL, SND_PURGE)，且需确保调用线程与播放线程一致（通常就是主线程） - 若 WAV 文件本身含静音头/尾，
SND_LOOP会把那段也循环进去，听感卡顿
替代方案：为什么建议避开 PlaySound 直接用更底层的 waveOut API
PlaySound 封装太浅，没法控制音量、声道、采样率适配，也不支持播放中途暂停/定位。真要稳定控制，应转向 waveOutOpen + waveOutWrite：
立即学习“C++免费学习笔记（深入）”；
- 可精确指定
WAVEFORMATEX结构，兼容非标准采样率（如 44.1kHz WAV 在某些声卡上会被PlaySound拒绝） - 播放缓冲区可控，避免大文件加载时内存暴涨
- 支持回调函数（
WAVEHDR.dwFlags |= WHDR_DONE），方便做播放完成通知 - 错误码明确：
waveOutOpen返回MMSYSERR_INVALPARAM比PlaySound的静默失败更容易排查
示例关键片段：
WAVEFORMATEX wfx = { .wFormatTag = WAVE_FORMAT_PCM, .nChannels = 2, .nSamplesPerSec = 44100, .wBitsPerSample = 16 };
跨平台和现代 C++ 项目的现实选择
如果项目要跑 Linux/macOS，或你用的是 CMake + Conan，硬绑 PlaySound 是自限死路。此时应：
- Windows 下优先封装
IAudioClient（WASAPI），它支持低延迟、共享/独占模式，且是 Win7+ 官方推荐路径 - Cross-platform 场景直接集成轻量库，比如
miniaudio：头文件仅一个miniaudio.h，ma_device_start()一行启动，自动选后端（WASAPI/ALSA/CoreAudio） - 避免在构造函数或 DLL 入口里调用
PlaySound：部分安全策略或沙盒环境会拦截多媒体 API 初始化，导致首次调用失败
真正麻烦的从来不是“怎么播出来”，而是“播得准、停得稳、换得顺”——这些 PlaySound 都不负责。
