Windows系统下Python中GDAL包安装指南（零基础也能轻松搞定！）

前言

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

pip install GDAL

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

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

个人电脑配置说明

OS：Windows 11 Enterprise（MacOS和Linux的朋友，爱莫能助，我的确没试过）

Version：24H2 （有的朋友是Win10版本，或者22H2，都是可以的）

System Type：AMD64（划重点，待会儿要用）

IDE：Cursor 0.46（PyCharm，Conda，VSCode等，都是可以的）

Terminal：PowerShell Preview 7.6.0-Preview.2（PowerShell，Cmd，都是可以的）

Broswer：Chrome  Version 133.0.6943.127 (Official Build) (64-bit) (啥浏览器都可以)

Python：Version 3.12.9 64-bit (CPython ) （自行下载，默认你有，站内有教程）

NetWork：我默认各位打得开Github，站内有教程。

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

具体操作

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

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

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

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

按住：Win+R（键盘上那个带浮标的），然后输入：cmd

在自己的Terminal（终端）输入：

python

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

第二步：去下载安装文件

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

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

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

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

答案：这个网页往下继续翻阅，一个一个点开Assets，在过去的更新中，总会有你需要的版本。

还有朋友问：最近出新版本的GDAL包了，我该如何更新？

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

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

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

和刚才一样，打开cmd终端

首先输入：（输入完按回车）

python

紧接着输入：（输入完按回车）

import sys

最后输入：（输入完按回车）

print(sys.path)

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

第四步：输入正确的安装指令

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

pip install GDAL-3.10.1-cp312-cp312-win_amd64.whl

得到的结果如下：我的旧版本在更新的过程中被卸载了。成功安装好了新版本，这也说明，我的电脑和python版本可以是适配3.10.1的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.

作者：菩提树下呀