写在最前面：遇到error我们不要怕，冷静地看一看报错内容，分析一下问题原因，然后baidu解决方案，我也是这样一路走下来的，集各家之经验，才有了这份教程。

一、缘起

本人要进行交通时空数据分析，使用的是同济大学小旭学长的教程(https://gitee.com/ni1o1/pygeo-tutorial)，里面要用到geopandas包。

在群里和其他同学交流之后也发现大家在安装这个包时吐槽连连，我也是从未安装过如此傲娇的包，故记之以示后学者。

二、geopandas是什么？

有很多关于geopandas的介绍，我在这里就不赘述了，推荐一个文章：朱卫军：geopandas，用python分析地理空间数据原来这么简单！​zhuanlan.zhihu.com

三、教程

1. 官方安装指南

我们遇到什么bug都不要怕，微笑着debug。有python装包经验的推荐使用官方安装指南，

下面的方法也是从官方安装指南中扩展出来的。

2.使用conda安装

如果有外网vpn，可以使用此法。

为什么不换源再用这个方法呢？

答：使用清华源会卡住，之后会报错，所以我猜测清华源中没有这个包。

打开Anaconda Prompt，

输入：

conda install geopandas

或

conda install --channel conda-forge geopandas(推荐)

最便捷，一路y下来，爽yy。但是最后也可能报错。

ImportError: DLL load failed: 找不到指定的模块。

解法见下文。

3.使用pip安装

如果没有外网vpn，用上述方法的感觉像极了吃奥力给(慢)，这里要换到国内源(换源教程网上有很多，我这里在最后说一下我的操作方法)

geopandas直接用pip安装可能会报错，需要先安装其依赖包：gdal、Shapely、Fiona、pyproj

安装的准备工作：卸载已经存在的依赖包：

首先也是最重要的一点，不要直接使用pip安装，通常会出现一些模糊的或莫名其妙的错误，使故障分析变得困难。Pip uninstall xxx。例：卸载gdal

pip uninstall gdal

之后安装这些依赖包，这里推荐使用whl文件安装，下载网址：

看清楚自己的python版本是3.x？和系统版本，然后找到相应的文件下载。

比如我是python3.7，64位系统，我就下载了GDAL-3.0.4-cp37-cp37m-win_amd64.whl

然后就开始安装这个包，把这个包放在Anaconda文件夹下的scripts文件夹内(图片中显示的是fiona包被我拖到里面了)，打开Anaconda Prompt，中输入pip install 再把这个whl文件按住拖动到pip install 后面，回车安装。

以fiona为例：

同理再安装其他3个包：(例子用的是fiona，我最开始安装的是GDAL，GDAL是fiona的依赖包，所以要先安)

我这里是

1. pyproj-2.6.0-cp37-cp37m-win_amd64.whl

2. Fiona-1.8.13-cp37-cp37m-win_amd64.whl

3. Shapely-1.7.0-cp37-cp37m-win_amd64.whl

全部安装好这些依赖包之后，再打开Anaconda Prompt，输入

pip install geopandas

y下去，如果没有报错，那就是初步成功了。

4.验证是否安装成功

简单粗暴地打开Jupyter Notebook，创建一个新python文件，

Import geopandas

如果没有报错，那就是大概成功了。

这时候我们在网上找一段代码，看看能不能实现，如果能实现，那就是ok了。

如果之前出现报错：

ImportError: DLL load failed: 找不到指定的模块.

继续验证：

import sys

'geopandas' in sys.modules

如果返回False，这就说明表面上看起来安装完成了，实际上geopandas是没有安装成功的。

(这种情况可能出现在使用conda安装的方法)

这时候我们挨个import 依赖包，

import gdal ，import fiona，...

哪个报错就说明哪个依赖包直接直接从conda-forge安装是有问题的，虽然安装成功了，但是import 却提示失败，说明不能用。

例：fiona出现问题，我们先pip uninstall fiona(卸载)，再下载fiona的whl文件并安装，

再验证import fiona ，没有报错，此时再测试geopandas是可用的，说明问题解决了。(可以看出从conda-forge直接安装的Fiona在我这里是不能用的)

之后如果报错，大概是缺什么额外补充的包，那么就补什么包，我这里最后缺了个descartes 1.1.0，是在

下载whl文件安装的。

5.换清华镜像源

由于国外源的链接速度十分十分的慢，所以要换到国内的镜像源，亲测清华源目前已经恢复服务了，所以我们换成清华源：

方法：

①打开Anaconda Prompt；

输入：

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/

输入：

conda config --set show_channel_urls yes

这时候我们已经添加了清华镜像源。

②也可以在C盘 中用户(user)文件夹下找到你的用户名的文件夹，发现里面有一个.condarc文件，打开，在里面输入

- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main

然后保存。

四、总结

由于geopandas的依赖关系比较复杂，所以安装方法不当，结果会是报错连连，本文旨在提供几种亲自测试过的方法，以帮助其他人少走弯路。当然，在实际操作过程中也有可能遇到其他的错误，这时候就要再看看我写在最前面的话啦，祝大家装包顺利，技能点max。

如果觉得有用就给我点个赞吧，谢谢。

如需转载，请注明出处，谢谢。