2025！在Windows的Python中安装GDAL包（小白能成！）_gdal安装
最近更新
在2025.06.05日，GDAL发布预告：新版本将适配pipeline和向量读写功能。
直到2025.06.25日，最新的版本才算发行出来。
有朋友催我赶紧更新教程，我上次更新是3月份的时候了，恰好是GDAL上一个版本出来的时间。
前言
很多大气，地理，环境，生态，遥感，城市空间规划等专业的朋友，在各种终端尝试
pip install GDAL指令时，都会遇到各种各样奇怪的报错，无论如何都安不上。说实话这条路走不通，不怪你。
因为GDAL不是标准的python库，不能直接用pip指令，进行管理操作。
实际证明，这样走不通的，请你放弃幻想。跟着这个教程一步一步的操作，你大概率是可以成功的。我会尽可能的详细，一步一步，足够缓慢，足够让每个第一次安装的朋友都能够明白。
感谢北京师范大学地理学院的朋友提供的帮助，我将把这个方法详细记录，希望可以帮助到更多朋友。
个人电脑配置说明
OS：Windows 11 Enterprise（MacOS和Linux的朋友，建议拉到文末，采用Conda指令安装）
Version：24H2 （有的朋友是Win10版本，或者22H2，都行）
Compile Architecture：AMD64（划重点，待会儿要用）
IDE：Cursor 1.2.2（PyCharm，Conda，VSCode等，都是可以的）
Terminal：Cmd（这是系统自带的，不需要下载，每个人都有）
Broswer：Chrome Version 138.0.7204.97 (Official Build) (64-bit) (能打开网页就行)
Python：Version 3.13.5 64-bit (CPython ) （自行下载好，站内有Python下载教程）
NetWork：🔮，🪜，我默认各位打得开Github，站内有教程。
这个方法主要是wheel格式文件（.whl）手动下载，手动输入指令安装，我第一次只用了10分钟就完成了，但是在此之前，两天都没能安上。
具体操作
第一步：确定Python版本和编译架构
这一步很重要，GDAL包不是随便找个版本就能用，因为不同版本的GDAL包只能适配特定版本的Python，所以必须知道Python的版本。这样可以寻找到，对应版本且合适能用，的GDAL包。
就像生物疫苗，一种疫苗，它只能特异性克制一种病毒，别的都不行。有病的时候，不是随便打一针奇怪疫苗，病就能好，这好不了。
如果下载的GDAL包，与，Python和编译架构对不上，就会报错，这样绝对安不上！
按住：Win + R（键盘最下面，那个带浮标的）
跳出弹窗如下，然后手动输入：cmd，然后点OK
在自己的Terminal（终端）输入：
python得到如下的结果：我的Python是3.13.5的版本，各位朋友可以看看自己的。不是非要和我一样才行，你的3.10或者3.11，或者其他版本，都是可以的。
MSC v.1943 64 bit (AMD64): 这是编译器的信息，表示这个Python解释器是用Microsoft Visual C++ (MSC) 编译器的1943版本编译的，支持64位（AMD64）架构。
支持AMD64的意思，就是和ARM区分，和32位区分，GDAL版本众多，要选择符合当前电脑的。
有的人是32位的，有的人是ARM架构的，反正你得先知道自己电脑的版本。
第二步：去下载安装文件
最新GDAL下载网址：https://github.com/cgohlke/geospatial-wheels/releases
我默认你是可以打开Github类的网页，有疑问或打不开，可以在站内查询攻略
很可能没有展示完毕，再点一下，全部展开！
根据自己电脑的python版本，编译架构，下载相适配的版本。
于我而言，我该下载：gdal-3.11.1-cp313-cp313-win_amd64.whl
点击下载适合自己电脑和Python版本的GDAL文件，保存到电脑桌面上。（Github文件下载速度太慢的朋友，考虑站内搜索加速办法，我默认你会）
我现在回答一下，有的朋友问：我的Python是3.9或3.8的老版本，这里没有啊，怎么办？
答案：在这个网页往下继续翻阅，资源在以前的更新中，一个一个点开Assets，总会有你需要的版本。
还有朋友问：最近出新版本的GDAL包了，我该如何更新？
答案：能不更新就不更新，除非你的版本已经不能用了。必须采取新版本的新功能，满足我当前的工程需要！此时你才需要更新，平时没有那么多功能用得上。
更新的套路就是：卸载旧版本后，确保能够适配的新版本情况下，下载并安装。
（如何卸载：文章后面会讲，卸载倒是很easy）
第三步：找到正确的安装路径
我们需要找到Python软件中名为：“Scripts”的文件夹路径。很多朋友找不到这个文件夹在哪，其他攻略也没写，我来“好为人师”一次，就当献丑了。
和刚才一样，按下win+R，打开cmd终端
首先输入：（输入完按回车）
python紧接着输入：（输入完按回车）
import sys最后输入：（输入完按回车）
print(sys.path)列表中的倒数第二个将是你的安装路径：
第四步：在安装路径放入文件
按住win + E ，在文件夹中，根据名称，一步一步找到它的位置，速度快只需要30妙。（我个人会采用这个方法，我比较传统）
当然还有一种简便方法，就是打开记事本，编辑一下路径，然后粘贴到位。（好朋友提供的办法）
在桌面上，将下载好的GDAL包，拖动到指定的📁内。
完成后，那儿也不要去，就在当前📁，在路径框内输入CMD。
像我这样操作，就好了，很简单。
第五步：输入正确的安装指令
按下回车↩️的效果是这样的，你需要看到类似的。
最后只需要简单的输入指令：
pip install gdal-3.11.1-cp313-cp313-win_amd64.whl当然具体版本，视每个人的电脑情况而定，你下了什么文件，你就把文件名替换上去即可。
pip install \"复制你下载到桌面的文件名，后缀.whl，也带上\"展示安装好的截图：
得到的结果如下：成功安装好了新版本，这也说明，我的电脑和python版本可以是适配3.11.1的GDAL包。⚠️警告warning，是可以忽略的，我顶着警告⚠️，照样正常使用。而第一次安装成功的朋友，只会有一个返回说明:
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
一些常见问题和解决方案
问题1.ERRR: gdal-3.11.1-cp313-cp313-win_amd64.whl is not a supported wheel on this platform.
解决办法：
1.请检查你的python是pip管理还是conda管理，conda指令更简单。
2.请检查你都python版本是不是3.13.x，确保最新的GDAL可以对应你的python大版本。
3.确定CPU编译框架是否为AMD64，有的朋友是ARM框架，这俩容易混淆，因为都是A开头的。
问题2.Unable to create process using \'C:\\Users\\QIZ Peng\\miniconda3\\python.exe \"C:\\Users\\QIZ Peng\\miniconda3\\Scripts\\pip-script.py\" install GDAL-3.9.2-cp39-cp39-win_amd64.whl\'
解决办法：
你的python管理不是pip系列，而是conda系列。conda系列更简单，只需要输入：conda install gdal 这个指令就好了，conda有标准的包。具体可以看文末其他推荐第一条。
问题3.pip list都能看到gdal，但是from osgeo import gdal还是会报错
原因：GDAL 安装了，但 Python 找不到 native DLL
GDAL 是一个 C/C++ 库，Python 包只是它的封装。如果系统找不到 GDAL 的 DLL（比如 gdal.dll），就会报错。
-
ImportError: DLL load failed: 找不到指定的模块（最典型） -
ModuleNotFoundError: No module named \'_gdal\'
解决办法：
1. 卸载之后，用教程相同的办法，重新安装。
2.将osgeo添加到系统变量和环境变量的path。
-
按
Win + S，搜索 “环境变量” -
点击 “编辑系统环境变量”
-
点击 “环境变量”
-
在 “系统变量” 或 “用户变量” 中找到
Path -
添加上面的
osgeo目录路径 -
重启命令行或 IDE
其他推荐：
2025！使用Conda安装GDAL（一行指令就行！）-CSDN博客
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.
