使用国内pip源安装tushare时超时错误怎么办？-量化交易-财云量化

摘要：

在国内用pip源安装tushare可能遇超时错误，原因与国外源有关，有多种解决方法，如用临时国内镜像源、设默认源、增超时时间等。

一、国内pip源安装tushare 超时错误的原因

当我们在国内使用pip安装tushare时，常常会遇到超时错误。这主要是因为默认的PyPI源位于国外。大家都知道，网络连接到国外服务器时，由于网络环境复杂、距离远等因素，下载速度会非常慢，而且连接很不稳定。这就像我们在一个信号不好的地方打电话，声音断断续续，数据传输也是如此。在这种情况下，就很容易出现超时错误，导致tushare无法正常安装。这种现象在安装一些大型的或者依赖项较多的Python包时更为常见。

二、使用临时国内镜像源解决超时错误

（一）清华大学镜像源示例

最方便快捷的解决方法之一就是使用临时国内镜像源。就拿清华大学的镜像源来说吧，它可是非常好用的。在安装tushare的时候，我们只需要在安装命令中加入清华大学镜像源的地址就可以了。例如，我们可以在命令行中输入：

pipinstalltushare-ihttps://pypi.tuna.tsinghua.edu.cn/simple

这个命令就像是给pip指明了一条快速通道，让它直接从清华大学的镜像源去下载tushare包。这样做通常就能很有效地避免因为从国外源下载而产生的超时问题。而且，如果我们需要安装特定版本的tushare，操作也很简单，只需要在包名后面加上版本号就可以了，就像这样：

使用国内pip源安装tushare时超时错误怎么办？

pipinstalltushare==1.0.1-ihttps://pypi.tuna.tsinghua.edu.cn/simple

三、设置默认国内镜像源

（一）Windows用户设置

对于Windows用户来说，如果想要一劳永逸，以后安装其他的Python包也能自动使用国内镜像源，就可以配置pip的配置文件来永久更改源。我们要在用户目录下创建或者修改pip\pip.ini文件，这个文件的路径可能是C:\Users\用户名\pip\pip.ini。然后，在这个文件里添加以下内容：

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

这样设置之后，以后每次使用pip安装包的时候，就会自动从我们设置的国内镜像源进行下载了。

（二）Linux或macOS用户设置

Linux或macOS用户也可以进行类似的操作。我们需要在用户目录下创建或者修改.pip/pip.conf文件，然后添加和Windows用户类似的内容：

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

这里设置trusted-host可是很重要的哦，它能够避免因为使用非默认源而出现的信任警告，就像我们进入一个新的场所，需要得到信任许可一样。

四、增加超时时间

有时候，我们可能偶尔会遇到一些特殊情况的超时，但又不想改变默认源或者想继续使用特定的国外源，这个时候我们可以通过增加pip的默认超时时间来解决问题。在命令行中，我们可以这样操作：

pipinstall--default-timeout=1000tushare

我们把超时时间设置为1000秒，这可比默认的时间长了很多呢。这样就大大增加了等待时间，从而减少了超时的可能性。这就好比我们给一个人更多的时间去完成一件事情，那么他成功完成的概率就会提高。

五、处理不信任主机警告

当我们使用国内镜像源的时候，可能在首次使用时会遇到SSL证书不信任的警告。这就像我们遇到了一个看起来不太可靠的陌生人，系统会对其产生怀疑。不过不用担心，我们可以通过添加--trusted-host参数来信任特定的镜像源。就像我们在前面配置文件中做的那样，我们也可以直接在命令行中指定，比如：

pipinstalltushare-ihttps://pypi.tuna.tsinghua.edu.cn/simple--trusted-hostpypi.tuna.tsinghua.edu.cn

这样就可以消除警告，顺利进行安装了。

六、检查网络状况

虽然更换国内镜像源能够解决大部分的超时问题，但我们也不能忽略本地网络状况的影响。如果本地网络状况不好，就像道路坑坑洼洼一样，即使我们选择了最快的运输路线（国内镜像源），货物（数据）也可能无法顺利到达。所以我们要确保自己的网络连接是稳定的，特别是在下载一些大文件的时候。比如说，如果我们的网络带宽很小或者网络波动很大，那么即使我们使用了国内镜像源，也可能会遇到超时或者下载失败的问题。

七、分步安装依赖

有时候，一个包的安装失败可能是因为它的依赖项在下载的时候出了问题。就好比盖房子，如果地基（依赖项）没打好，房子（主包）就盖不起来。对于tushare来说，它依赖于lxml、requests等。我们可以先单独使用国内源来安装这些依赖项，就像这样：

pipinstalllxml-ihttps://pypi.tuna.tsinghua.edu.cn/simplepipinstallrequests-ihttps://pypi.tuna.tsinghua.edu.cn/simple

等把这些依赖项都安装好之后，再安装tushare，这样就可以提高安装成功的概率。

八、更新pip本身

我们要确保pip是最新版本的。因为旧版本的pip可能存在一些问题，比如说不支持某些优化，或者没有修复一些已知的连接问题。就像我们使用的工具，如果是旧的、有缺陷的，那么工作效率就会大打折扣。更新pip可以使用下面这个命令：

pipinstall--upgradepip

如果我们想要使用国内镜像源来更新pip，也可以这样做：

pipinstall--upgradepip-ihttps://pypi.tuna.tsinghua.edu.cn/simple

通过保持pip的更新，我们能够更好地利用各种源来安装Python包，减少安装过程中出现问题的可能性。