python中geopandas库安装出现各种问题的解决办法_Python

前言

地理信息相关数据的处理是一种很常见的需求，开源python库geopandas提供了方便的地理空间数据操作工具。其强大功能受到了众多gis开发者的厚爱。奈何geopandas库太难安装了，第一次安装这个库的朋友或多或少会遇到一些奇奇怪怪的问题！

对于一般的python库，只需一条conda命令或者pip命令即可成功安装使用。但是对于geopandas，无论是使用conda install geopandas还是pip install geopandas都会出现问题！要么安装不了库，要么安装了库却无法使用！

本文结合自身经验，总结了在windows环境下两种安装geopandas库的方法，并用anaconda工具在python3.9版本下测试均可成功安装并使用。需要提前安装anaconda管理工具！

方法一、在新环境下使用conda命令安装

对于一个现有的环境，想要使用conda命令直接安装geopandas成功的概率是非常低的。经过互联网搜索，发现在anaconda下创建一个新环境后立刻使用conda命令安装geopandas就能成功。

此方法原理目前未知，但实测能成功安装并使用geopandas，其步骤如下：

1.打开anaconda prompt并新建环境

使用create命令新建一个名为test的环境，并指定python版本为3.9（推荐使用3.9以上的python版本，因为支持3.9以下的有些gis相关的库whl文件不好找了）：

conda create --name test python=3.9

创建新环境完毕后，可以使用以下命令查看所建环境是否在环境列表中：

conda env list

激活进入新环境：

conda activate test

2.安装geopandas

创建test环境完毕并激活后，立刻使用install命令安装geopandas（如果在这之前安装其他的库，尤其是pandas、numpy和matplotlib，很可能导致geopandas安装失败）：

conda install geopandas

安装完毕后，使用conda list geopandas查看库是否安装成功。如能正确显示版本信息，即安装成功：

在anaconda下，使用python命令进入python解释器，使用import geopandas测试能否正确导入库。如果没有显示报错信息，则导入成功：

至此，geopandas已经安装成功了。还可以使用几条简单代码测试其功能是否能正常使用，因本人测试简单功能没有问题，这里就不再赘述了。

有一点值得一提。geopandas有很多依赖库。除了numpy和pandas等这种基本的数学库外，还有gdal、fiona、pyproj、rtree、shapely等地理相关的库。但是用此方法安装的geopandas没有fiona和rtree库！为了防止使用一些功能时出现问题，建议单独安装fiona和rtree库。单独安装库的方法见方法二。

方法二、通过whl离线安装

先离线安装gdal、fiona、pyproj、rtree、shapely五个库，再用pip install geopandas即可。

1.离线安装五大依赖库

将gdal、fiona、pyproj、rtree、shapely五个库的whl文件从网上下载到本地，下载地址：https://github.com/cgohlke/geospatial-wheels。

这里需要注意一个问题，一定要下载对版本，首先要从文件名看懂信息。例如对于文件gdal-3.8.4-cp39-cp39-win_amd64.whl，3.84表示gdal库的版本，cp39表示对应python3.9的whl文件，win_amd64表示windows64位系统。前面之所以推荐用3.9以上的python版本，是因为支持3.8python以下的whl文件该网站上已经没有了！

我的版本是python3.9，我的五个库使用的版本可以参考如下:

库	版本
gdal	3.8.4
fiona	1.9.5
pyproj	3.6.1
rtree	1.2.0
shapely	2.0.5

将五个库的whl文件下载到本地后按照gdal、fiona、pyproj、rtree、shapely的顺序进行pip离线安装。

打开anaconda prompt，进入需要安装geopandas库的环境，假设其环境名为test。

conda activate test

找到下载的gdal文件，右键，选择复制文件地址，获得该文件的绝对地址 “c:\users\26514\downloads\gdal-3.8.4-cp39-cp39-win_amd64.whl” ，使用pip命令进行安装：

pip install "c:\users\26514\downloads\gdal-3.8.4-cp39-cp39-win_amd64.whl"

稍作等待后安装，可用conda list gdal来验证是否安装成功，出现如下信息后表示安装成功：

另外四个库的安装方法和gdal相同，按次序重复操作即可，这里就不做赘述。

2.使用pip命令安装geopandas

安装好上面五个库后，可以在相同环境中使用pip命令安装geopandas了：

pip install geopandas

三、导入测试

成功安装好geopandas后，可以在python中import测试是否可以成功导入geopandas、gdal、fiona、pyproj、rtree、shapely这几个库。例如我在pycharm的控制台中，使用import geopandas来测试geopandas能否正常导入，其他包同理。

有一点需要注意，除了gdal库以外，其他包的import应该会没有问题。但若使用import gdal时，会出现报错。别慌！这是gdal库的问题，我们只需要把命令改成from osgeo import gdal，再测试如果没有报错则万事大吉！

最后导入六个包的正常情况如下：