Python speech_recognition模块语音识别代码运行光标闪烁无响应问题

故障根因 #

• 麦克风权限未开放：系统未给当前运行代码的终端/IDE授予麦克风访问权限，程序无法获取音频输入直接卡住
• 麦克风设备索引不匹配：默认调用的索引0设备不是你正在使用的麦克风，程序无法读取到音频流
• 环境校准与监听逻辑无超时：adjust_for_ambient_noise执行期间需要保持环境安静不能说话，否则校准后的能量阈值过高会导致listen方法一直等待有效语音输入，且默认无超时设置会无限阻塞
• 谷歌接口无法访问：recognize_google依赖谷歌服务，国内网络环境下无法访问会导致请求无限挂起

修复步骤 #

1. 开放麦克风权限
   进入系统隐私设置，给运行代码的终端、PyCharm/VSCode等IDE开启麦克风访问权限
2. 确认麦克风设备索引
   单独运行以下代码打印所有可用麦克风设备，记下你要使用的设备对应的索引值：

import speech_recognition as sr
print(sr.Microphone.list_microphone_names())

3. 修改代码添加超时设置、指定设备索引，国内用户建议替换识别接口
   优化后代码示例：

import speech_recognition as sr

r = sr.Recognizer()
# 此处替换为你上一步查到的目标麦克风索引
mic_index = 0
with sr.Microphone(device_index=mic_index) as source:
    print("请保持环境安静，正在校准噪音（2秒）...")
    # 校准期间不要说话
    r.adjust_for_ambient_noise(source, duration=2)
    print("校准完成，请说话：")
    # timeout：5秒内没检测到声音就抛异常终止，phrase_time_limit：最多识别10秒语音
    audio = r.listen(source, timeout=5, phrase_time_limit=10)
    try:
        # 国内用户如果无法用谷歌接口，可替换为离线识别方案（需提前安装pocketsphinx库）
        # text = r.recognize_sphinx(audio, language='zh-CN')
        text = r.recognize_google(audio, language='zh-CN')
        print("识别结果：", text)
    except sr.WaitTimeoutError:
        print("超时未检测到有效语音")
    except sr.UnknownValueError:
        print("无法识别语音内容")
    except sr.RequestError:
        print("识别服务请求失败，请检查网络或更换识别接口")

4. 离线识别依赖安装
   如使用pocketsphinx离线识别，执行命令安装依赖：
   pip install pocketsphinx

内容的提问来源于stack exchange，提问作者Shadowhunter 1