2025!在Windows的Python中安装GDAL包(小白能成!)

前言

很多大气,地理,环境,生态,遥感等专业的朋友,在各种终端尝试

pip install GDAL

指令时,都会遇到各种各样奇怪的报错,无论如何都安不上。说实话这条路走不通,不怪你。

因为GDAL不是标准的python库,不能用pip进行管理。

实际证明,这样走不通的,请你放弃幻想。跟着这个教程一步一步的操作,你大概率是可以成功的。我会尽可能的详细,一步一步,足够缓慢,足够让每个非专业的朋友都能够使用上。感谢北京师范大学地理学院的朋友提供的帮助,我将把这个方法详细记录,希望可以帮助到更多朋友。

个人电脑配置说明

OS:Windows 11 Enterprise(MacOS和Linux的朋友,爱莫能助,我的确没试过)

Version:24H2 (有的朋友是Win10版本,或者22H2,都是可以的)

System Type:AMD64(划重点,待会儿要用)

IDE:Cursor 0.48.7(PyCharm,Conda,VSCode等,都是可以的)

Terminal:PowerShell Preview 7.6.0-Preview.3(PowerShell,Cmd,都是可以的)

Broswer:Version 135.0.7049.42 (Official Build)  (64-bit) (啥浏览器都可以)

Python:Version 3.13.2 64-bit (CPython ) (自行下载,默认下好,站内有教程)

NetWork:🔮,🪜,我默认各位打得开Github,站内有教程。

这个方法主要是wheel格式文件(.whl)手动下载,手动输入指令安装,我第一次只用了10分钟就完成了,但是在此之前,两天都没安上。

具体操作

第一步:确定Python和编译的版本

这一步很重要,GDAL包不是随便一个版本就能用,因为不同版本的GDAL包只能适配特定版本的Python,所以必须知道Python的版本,这样可以寻找到,对应版本且合适能用,的GDAL包。

就像生物疫苗,一种疫苗,它只能特异性克制一种病毒,别的都不行。有病的时候,不是随便打一针奇怪疫苗,病就能好,这好不了。

如果下载的GDAL包,与,Python和编译版本对不上,就会报错,这样绝对安不上!

按住:Win+R(键盘上那个带浮标的),然后输入:cmd


在自己的Terminal(终端)输入:

python

得到如下的结果:我的Python是3.13.2的版本,各位朋友可以看看自己的。不是非要和我一样才行,你的3.10或者3.11,或者其他版本,都是可以的。我的电脑是基于X86_64位的AMD架构,有的朋友是32位,旧电脑我曾见过。手机倒是经常看到ARM架构。


第二步:去下载安装文件

最新网址:https://github.com/cgohlke/geospatial-wheels/releases

我默认你是可以打开Github类的网页,有疑问或打不开,可以在站内查询攻略。


根据自己电脑的python版本,CPU架构,下载。

我下载:gdal-3.10.2-cp313-cp313-win_amd64.whl

点击下载适合自己电脑和Python版本的GDAL文件,保存到电脑桌面上。(Github文件下载速度太慢的朋友,考虑站内搜索加速办法,我默认你会)


我现在回答一下,有的朋友问:我的Python是3.9或者3.8版本,这里没有啊,怎么办?

答案:这个网页往下继续翻阅,资源在以前的更新中,一个一个点开Assets,总会有你需要的版本。

还有朋友问:最近出新版本的GDAL包了,我该如何更新?

答案:能不更新就不更新,除非你的版本已经不能用了,只有新版本的新功能满足我的工程需要,此时你才需要更新,平时没有那么多功能用得上。更新的套路就是:卸载旧版本后,确保能够适配的新版本情况下,下载并安装。

第三步:找到正确的安装路径

我们需要找到Python软件中名为:“Scripts”的文件夹路径。很多朋友找不到这个文件夹在哪,其他攻略也没写,我来“好为人师”一次,就当献丑了。

和刚才一样,打开cmd终端

首先输入:(输入完按回车)

python

紧接着输入:(输入完按回车)

import sys

最后输入:(输入完按回车)

print(sys.path)

列表中的倒数第二个将是你的安装路径:


第四步:在安装路径放入文件

按住win + E ,在文件夹中,根据名称,一步一步找到它的位置,速度快只需要30妙。(我个人会采用这个方法,我比较传统)

当然还有一种简便方法,就是打开记事本,编辑一下路径,然后粘贴到位。(好朋友提供的办法)

将下载好的GDAL包,移动到指定的路径下。


完成复制粘贴后,那儿也不要去,就在当前📁,在路径框内输入CMD。


像我这样操作,就好了,很简单。

第五步:输入正确的安装指令

按下回车↩️的效果是这样的,你需要看到类似的。

最后只需要简单的输入指令:

pip install gdal-3.10.2-cp313-cp313-win_amd64.whl

得到的结果如下:成功安装好了新版本,这也说明,我的电脑和python版本可以是适配3.10.2的GDAL包。报错是可以忽略的,我顶着报错,也能用。而第一次安装成功的朋友,只会有一个说明:

Successfully installed GDAL-XXXXX

具体的,XXXXX,视每个人的具体版本而定,但我想祝贺你,你已经成功安装好了GDAL包!

你将会在地图解析和卫星遥感中大展拳脚!

其他说明

验证是否能用

我们可以在IDE中新建一个python的demo文件,粘贴一下代码,看看效果。

如果有路径报错,在最后面有三个教程可以看看,解决路径问题。

如果没有报错,那就忽略警告,继续正常使用。

from osgeo import gdal

# 打开一个 GeoTIFF 格式的栅格数据文件
dataset = gdal.Open('example.tif')

在Cursor这个IDE的Terminal处输入指令:(能查看过去所有安装过的包)

pip list

卸载GDAL的操作

在Cursor这个IDE的Terminal处输入指令:(能自动检测已有的GDAL包和版本)

pip uninstall GDAL

其他推荐:

GDAL简介与安装-CSDN博客

【转载】在Python中安装GDAL(最简单,最详细图文教程)_gdal下载whl-CSDN博客

GDAL库简介及函数说明-CSDN博客

GDAL — GDAL documentation

GitHub - OSGeo/gdal: GDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.

### 如何在Python安装GDAL库 #### 准备工作 为了成功安装GDAL库,需确认操作系统已安装必要的依赖项。对于Windows用户来说,通常推荐下载预编译的二进制文件来简化安装过程[^1]。 #### 使用Wheel安装GDAL 一种简便的方法是通过`wheel`格式的预构建来进行安装。这可以避免手动配置环境变量以及处理复杂的依赖关系。具体操作如下: 1. 访问[Christoph Gohlke 的 Unofficial Windows Binaries](https://www.lfd.uci.edu/~gohlke/pythonlibs/#gdal),找到适用于当前系统的版本并下载对应的`.whl`文件。 2. 打开命令提示符窗口,并切换到保存有.whl 文件的位置。 3. 运行 `pip install <path_to_wheel_file>` 命令完成安装,其中 `<path_to_wheel_file>` 是所下载轮子文件的具体路径。 ```bash pip install GDAL‑<version>-py3-none-win_amd64.whl ``` 请注意替换上述命令中的`<version>` 和架构部分以匹配实际使用的 Python 版本和计算机体系结构。 #### 配置环境变量(如果必要) 有时可能还需要设置一些额外的环境变量以便让Python能够正确识别新安装GDAL库。特别是当遇到导入错误时,尝试将GDAL的bin目录添加至PATH环境变量中可能会有所帮助[^2]。 #### 测试安装是否成功 最后一步是在Python解释器里测试一下能否正常引入该模块: ```python import osgeo.gdal as gdal print(gdal.__version__) ``` 这段简单的脚本会打印出已经安装好的GDAL版本号,从而验证整个流程是否顺利完成。
评论 9
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

菩提树下呀

五毛钱可以吗,宝?

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值