解决osgeo库(GDAL python包)安装失败问题的方法

📅 2026/8/11 15:24:47
解决osgeo库(GDAL python包)安装失败问题的方法
当你运行from osgeo import gdal报错时通常是因为错误地执行了pip install osgeo而实际上需要安装的是gdal包。OsgeoOpen Source Geospatial Foundation是一个支持开源地理空间数据处理的基金会我们可以在python中使用“osgeo”库来访问其提供的高效地理空间数据。例如我们使用该模块提供的GDAL处理栅格数据使用OGR处理矢量数据使用OSR进行坐标系统参考和投影转换处理等。它的环境配置极其依赖于GDAL库Geospatial Data Abstraction LibraryGDAL也是一个开源库它的功能与osgeo库绑死了有助于Python更好地处理地理空间数据。这里想使用osgeo库进行tiff高程文件的数据处理在PyCharm安装gdal库的时候显示 ERROR: Failed building wheel for gdal。查阅了许多大佬的资料后发现osgeo模块的安装还是需要花点心思的写个文章分享一下记录一下解决这个麻烦的步骤。1 安装imagecodecs库第一步我们要安装imagecodecs库它支持多种常见的图像格式当然也包含我们的目标tif格式为方便后续的图像处理和安装osgeo模块先安装此库。1如果你是cmd命令很简单采用代码C:\Users\你的用户名python --version C:\Users\你的用户名pip install imagecodecs第一行是检查python版本进入python编译环境。检查完版本后第二步则是安装库。像下图你会看到如下结果说明安装imagecodecs库成功了2 安装GDAL依赖库这一步有点小麻烦GDAL库安装成功是osgeo库成功的关键。首先如果你直接在Pycharm找到GDAL库安装可能会出现和一开始安装osgeo库一样的问题都是显示没有Wheel支持因此我们要另寻出路手动安装。1找到GDAL的发布下载地址下载对应电脑版本和Python环境的GDAL库。给出GDAL不同版本下载地址https://github.com/cgohlke/geospatial-wheels/releases页面长这样是GitHub 上面的。我们往下翻找到GDAL库不同版本的下载链接(如果没有看到记得点击Assets模块的 Show all 140 assets图中红线所示)目前GDAL已经更新到了3.12版本这里主要看你的Python版本是什么版本小编用的是Python3.13电脑是64位的因此我们选择cp313的64位版本红色划线这里讲以下以下链接的区别gdal-3.12.2-cp313-cp313-win_amd64.whlgdal-3.12.2-cp313-cp313-win_arm64.whlwin_amd64适用于x64即 x86-64架构的处理器。这是目前绝大多数台式机、笔记本Intel Core 系列、AMD Ryzen 系列使用的标准架构。win_arm64适用于ARM64架构的处理器。这主要用在搭载了高通骁龙 X Elite 芯片、或苹果 M 系列芯片通过 Windows on ARM 运行的新款轻薄本或平板电脑上。所以电脑基本上选择win_amd64版本点击即下载该版本的安装包。2记住刚刚安装包的下载存储位置找到项目当前的工作环境。工作环境我们可以看PyCharm的控制台一般会显示比如本人的据此找到E:\Program Files\Python\PythonProject\你的工程名\.venv\Scripts python.exe前把刚刚下载好的安装包复制一份粘贴到这个这个目录下面。3正确使用cmd命令安装GDAL库接下来就是关键的一步我们还是键盘“WindowsR”进入“cmd”命令输入代码cd /d E:\Program Files\Python\PythonProject\你的工程名\.venv\Scripts这里的代码命令其实将cmd切换到项目Python的工作目录在目录下进行编程指令。接着继续输入代码pip install xxx.whl这里是配置你刚刚下载的GDAL库因为我这里已经安装好了一般会出现Successfully..的结果说明GDAL库就安装成功了。如果你不放心的话还可以在PyCharm的软件安装包中再搜索一遍恭喜你如果显示已安装说明GDAL库被你安装成功了接着我们回到当前的工作目录文件夹也会发现一大波和gdal有关的文件出现了接着回到上一个文件夹找到如下地址E:\Program Files\Python\PythonProject\你的工程名\.venv\Lib\site-packages点击site-packages打开库的已安装目录你会发现osgeo已经被安装了进一步打开osgeo模块发现我们一开始谈到的osgeo的一些处理地理空间数据的工具都顺利安装了。总结一下要安装osgeo模块关键在GDAL依赖库的安装如果能够顺利安装GDAL依赖库因其是osego的模块因此osgeo的部分模块也能够得到自动安装此时再运行代码发现代码并不报错能够正常运行了。本文分享就到这里了参考文献如下1如果还不会安装GDAL依赖库可以继续阅读探索Python融合地学一文解决osgeo库安装失败问题-CSDN博客