SpeechSynthesizer 默认无声主因是系统未安装或未选对TTS语音引擎；需调用GetInstalledVoices()确认，手动下载如“Microsoft XiaoYun”，显式SelectVoice；SpeakAsync异常需通过SpeakCompleted事件捕获；中文推荐专用引擎并合理设置Rate（0～1）和Volume（≤95）；部署时注意SAPI COM注册及用户配置文件。
SpeechSynthesizer 构造后直接调用 Speak 就能播，但默认没声音
多数人写完代码没反应，不是写错了，是系统没装语音引擎或没选对语音。Windows 自带的 SpeechSynthesizer 依赖系统 TTS 引擎（比如 Microsoft David、Zira），而 Windows Server 或精简版系统常不带这些语音包。
实操建议：
- 先运行
GetInstalledVoices()看返回列表是否为空：var voices = synthesizer.GetInstalledVoices();<br>Console.WriteLine($"找到 {voices.Count} 个语音"); - 若为 0，去「设置 → 时间和语言 → 语音 → 管理语音」手动下载中文（如“Microsoft XiaoYun”）或英文语音包
- 别依赖默认语音，显式指定一个已安装的：
synthesizer.SelectVoice("Microsoft XiaoYun"); - 语音名区分大小写，且可能含空格或版本号（如
Microsoft David Desktop和Microsoft David是两个不同项）
异步播报时 SpeakAsync 不阻塞线程，但异常不会抛到主线程
用 SpeakAsync 播报长文本很常见，但它内部是通过事件驱动完成的，Exception 不会冒泡到 await 处，而是触发 SpeakCompleted 事件里的 e.Error。
容易踩的坑：
- 写了
await synthesizer.SpeakAsync("hello")却没处理SpeakCompleted，结果异常静默失败 -
SpeakAsync在 UI 线程调用时，回调默认回到原上下文；但在控制台或后台线程中，SpeakCompleted可能不触发——因为没消息循环 - 如果需要可靠捕获错误，必须订阅事件并检查
e.Error：synthesizer.SpeakCompleted += (s, e) => {<br> if (e.Error != null) Console.WriteLine(e.Error.Message);<br>};
中文播报卡顿、发音不准，大概率是语音引擎不支持中文或语速/音量设错
不是所有系统语音都支持中文。比如英文版 Windows 自带的 Microsoft David 对中文基本是“拼音朗读”，声调全无；而 Microsoft XiaoYun 或 Microsoft Yaoyao 才是专为中文优化的。
参数影响明显：
-
Rate范围是 -10 到 10，默认 0；设成 2 以上中文容易吞字，-2 以下又太慢，建议中文用 0～1 -
Volume是 0～100，默认 100；某些引擎在音量 >95 时反而失真 - 避免用
SpeakSsml直接传 raw XML，没闭合标签或编码不对（如中文未 UTF-8）会导致静默失败 - SSML 中
<prosody>可微调语速/音高，但不是所有引擎都支持——Microsoft XiaoYun支持有限，别过度依赖
部署到其他机器时报错 System.Runtime.InteropServices.COMException
典型错误信息：HRESULT: 0x80040154 Class not registered，本质是 COM 组件注册缺失。Speech API 底层依赖 SAPI（Speech API）的 COM 接口，在无桌面环境（如 Windows Server Core、Docker 容器、服务账户下）默认不可用。
能做的只有三件事：
- 确认目标系统已启用「语音识别和语音合成」功能（PowerShell 执行
Enable-WindowsOptionalFeature -Online -FeatureName Speech-Creation） - 不要用 LocalSystem 账户运行服务——它没有用户配置文件，无法加载语音引擎；改用「此账户」并指定有语音配置的用户
- 生产环境慎用
SpeechSynthesizer：它不是为高并发设计的，同一实例不能被多个线程同时调用Speak；需隔离实例或加锁
