c#语音识别三大问题根源在于环境配置：speechrecognitionengine仅支持.net framework；azure语音sdk需匹配密钥区域并显式设zh-cn语言；windows需手动开启麦克风权限及中文语音包。
离线识别不准、在线识别连不上、中文输出为空——C#语音识别卡在这三类问题上，90%不是代码写错了，而是环境、配置或模型没对齐。
SpeechRecognitionEngine 构造失败或找不到类型
直接报错 CS0246: 未能找到类型或命名空间名称“SpeechRecognitionEngine”，说明你正在用 .NET 5+ 或 .NET Core 项目。这个类只存在于 .NET Framework 4.7.2 及以上版本，且必须是桌面应用（Console App (.NET Framework)），不是 (.NET Core) 或 (.NET 5/6/7/8)。
- 检查项目属性 → 目标框架，确认是
.NET Framework 4.7.2或更高 - 右键项目 → “添加引用” → 勾选
System.Speech（它不会自动出现在 NuGet 列表里） - 若用 Visual Studio 2022，默认新建项目可能强制选 .NET 6，得手动改项目文件：
<targetframework>net472</targetframework> - Windows 系统未安装中文语音包时，即使编译通过，运行时
SetInputToDefaultAudioDevice()也可能静默失败——去「设置 → 时间和语言 → 语音 → 下载语言」装好中文(简体)语音识别语言包
Microsoft.CognitiveServices.Speech SDK 连接失败或返回空结果
常见现象：控制台卡住、抛出 Connection failed，或 e.Result.Text 始终为空字符串，但没报异常。根本原因几乎都出在 SpeechConfig 初始化环节。
- 订阅密钥和区域必须严格匹配：Azure 门户中 Speech 资源的
Key和Region（如eastasia），不能填成 LUIS 或 TTS 的区域 - 语言必须显式设置：
speechConfig.SpeechRecognitionLanguage = "zh-CN"，不设就默认英文，中文输入会变乱码或空 - 音频输入别写错：
AudioConfig.FromDefaultMicrophoneInput()是听麦克风，FromFileInput()是读文件——手误写反会导致“一直听不到声音” - 测试连接是否通：用 PowerShell 快速验证密钥有效性：
Invoke-RestMethod -Uri "https://<your-region>.api.cognitive.microsoft.com/sts/v1.0/issueToken" -Headers @{'Ocp-Apim-Subscription-Key'='<your-key>'}</your-key></your-region>，返回 JWT 字符串即有效
DictationGrammar 识别率低、自由说话全错
DictationGrammar() 在 System.Speech 中本质是调用 Windows 自带的听写引擎，它没有神经网络模型，对语速、停顿、口音极其敏感。不是“不准”，而是设计上就不适合自由语音转文字。
- 仅建议用于短指令场景，例如固定命令集：
new Choices("打开", "关闭", "暂停")+GrammarBuilder - 若硬要用听写模式，必须满足：安静环境 + 标准普通话 + 语速适中 + 每句话有明显停顿
- 识别结果中
e.Result.Confidence常低于 0.3，可加判断过滤低置信度结果：if (e.Result.Confidence > 0.5) Console.WriteLine(e.Result.Text); - 真正需要自由文本识别，请直接切到
Microsoft.CognitiveServices.SpeechSDK——它的流式识别 + 神经语言模型才是为这个场景设计的
最常被忽略的一点：麦克风权限不是程序能弹窗申请的。Windows 隐私设置里必须手动打开「麦克风」开关，而且要勾选「允许此设备的应用访问麦克风」——哪怕代码里写了 SetInputToDefaultAudioDevice()，权限关着就是无声。这个开关藏得深，排查时先看它。
