Linux下使用pip安装SpeechRecognition连接超时如何解决

在Linux系统中使用pip安装SpeechRecognition时，连接超时是较为常见的问题，主要原因是pip默认从国外官方源下载资源，受网络波动影响容易出现下载速度慢、连接中断的情况。我们可以通过多种方法调整配置来规避这个问题。

临时使用国内镜像源安装

最直接的方法是安装时临时指定国内的pip镜像源，这样本次安装会直接从国内服务器拉取资源，速度更快更稳定。国内常用的镜像源有阿里云、清华大学、豆瓣等。

执行以下命令即可临时使用清华大学镜像源安装SpeechRecognition：

# 临时使用清华大学镜像源安装SpeechRecognition
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple SpeechRecognition

如果需要使用其他镜像源，只需要替换命令中的地址即可，比如阿里云镜像源地址为https://mirrors.aliyun.com/pypi/simple/。

永久配置pip镜像源

如果经常需要安装Python库，临时指定镜像源会比较繁琐，可以永久配置pip的默认镜像源，之后所有pip安装操作都会默认使用国内源。

创建pip配置文件

首先在用户目录下创建pip配置文件夹和配置文件：

# 创建pip配置目录
mkdir -p ~/.pip
# 创建pip配置文件
touch ~/.pip/pip.conf

写入镜像源配置

使用文本编辑器打开~/.pip/pip.conf文件，写入以下内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

配置完成后，直接执行pip install SpeechRecognition就会默认使用清华大学镜像源，无需每次手动指定。

调整pip超时时间

如果网络环境较差，即使使用了国内源也可能出现超时，可以调整pip的默认超时时间，延长等待连接的时长。

临时调整超时时间的命令如下：

# 设置超时时间为120秒，然后安装SpeechRecognition
pip --default-timeout=120 install SpeechRecognition

如果需要永久调整超时时间，可以在之前创建的~/.pip/pip.conf文件中添加超时配置：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
timeout = 120
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

验证安装结果

安装完成后，可以通过以下Python代码验证SpeechRecognition是否安装成功：

# 验证SpeechRecognition是否安装成功
import speech_recognition as sr
print("SpeechRecognition版本:", sr.__version__)

如果没有报错且正常输出版本号，说明安装已经完成，连接超时的问题已经解决。

常见问题说明

• 如果执行pip命令时提示权限不足，可以在命令前添加sudo，或者使用--user参数安装到用户目录，避免权限问题。
• 部分Linux发行版默认同时安装了Python2和Python3，需要根据实际使用的Python版本选择对应的pip命令，比如Python3通常使用pip3。
• 如果镜像源地址失效，可以替换为其他可用的国内镜像源地址，配置方式保持一致。

pipSpeechRecognitionLinux连接超时修改时间：2026-06-27 14:36:19