GDAL / OGR 学习手册 [01] ：Python环境配置

• • 一、GDAL/OGR 安装
  • • 1. 在线安装
    • • 方法1：默认环境安装
      • 方法2：虚拟环境安装
      • • Step1: 创建虚拟环境
        • Step2: 激活虚拟环境
        • Step3: 安装GDAL
    • 2. 离线安装
    • • Step1: 下载whl包
      • Step2: 离线安装GDAL
  • 二、GDAL/OGR 导入

OGR作为GDAL的子项目，现已集成在GDAL中，只需安装GDAL就能调用GDAL和OGR。

安装GDAL最直接的方法就是使用pip库：

该命令会在线安装最新版本的GDAL至默认的python环境。在安装完成后，通过pip show GDAL命令可以查看GDAL的安装位置。

除此之外，使用命令 pip install GDAL == [版本号] 可以指定GDAL的安装版本。

为了避免Python、第三方库之间的冲突，推荐使用虚拟环境（如Anaconda、Virtualenv等）。

以Anaconda为例，创建虚拟环境并安装GDAL的步骤如下：

Step1: 创建虚拟环境

在Anaconda Prompt中运行命令：conda create -n env_name python=x.x

注释：
env_name：拟创建的虚拟环境名
python=x.x：虚拟环境的Python版本

例如： 构建名为GISea，python版本为3.8的虚拟环境。

运行命令：conda create -n GISea python=3.8

弹出的提示信息包括：虚拟环境的创建位置、python版本和预装的包。



键入 y 确认，完成虚拟环境的创建。

Step2: 激活虚拟环境

在Anaconda Prompt中运行命令：conda activate env_name

注释：

env_name：拟创建的虚拟环境名

例如： 激活虚拟环境GISea：conda activate GISea
目录前面的（base）变成了（GISea），表明已经成功激活了虚拟环境GISea。

在激活状态下运行命令会对该虚拟环境进行操作。

Step3: 安装GDAL

在虚拟环境目录下运行命令：conda install GDAL

提示即将安装的一系列包：



键入 y 确认，完成GDAL的安装。

完成安装后，查找环境中的GDAL包，输入命令：conda list GDAL



结果显示GDAL（3.4.1）已经安装完成。

在线安装容易受网络、服务器等因素的影响导致安装失败，在这种情况下，可以尝试离线安装。离线安装通过手动下载whl文件，在本地进行安装。

离线安装的关键在于whl包版本的选择，使用命令：pip debug --verbose
查看当前Python版本支持的whl文件名：

安装包命名规则
例如：GDAL‑3.4.1‑cp38‑cp38‑win_amd64.whl :

    3.4.1： GDAL版本号
    cp38： Python版本为3.8
    win_amd64： 64 位操作系统，win32 对应32位操作系统

离线安装GDAL的步骤如下：

Step1: 下载whl包

访问Python包下载地址：

官网: https://pypi.org/

镜像（推荐）: https://www.lfd.uci.edu/~gohlke/pythonlibs/

下载与Python版本匹配的whl包：

Step2: 离线安装GDAL

在虚拟环境目录下运行命令：pip install whl_path

注释：
whl_path：whl包的绝对路径

例如：
whl包的绝对路径为：C:UsersPytranDesktopGDALGDAL-3.4.3-cp38-cp38-win_amd64.whl时，安装命令如下：

完成安装后，打开第三方包的存储位置：site-packages文件夹，可以看到并没有名为gdal的文件夹。

此时使用该虚拟环境直接导入gdal库：

 import gdal

可能出现无法找到该模块的问题：

尝试进入site-packages中的osgeo文件夹，可以找到gdal和ogr模块。

这说明安装GDAL的过程，实质上是安装了包含gdal和ogr两个子模块的osego包，因此使用如下语句即可成功导入gdal和ogr：

 from osgeo import gdal
 from osgeo import ogr

往期内容：
GDAL / OGR 学习手册 | 前言