最近更新2026.08.18日GDAL 3.13.3 发布更新新版本以修复bug为主提高稳定性有朋友催我赶紧更新教程我上次更新是2月份的时候了。前言很多大气地理环境生态遥感城市空间规划等专业的朋友在各种终端尝试pip install GDAL指令时都会遇到各种各样奇怪的报错无论如何都安不上。说实话这条路走不通不怪你。因为GDAL不是标准的python库不能直接用pip指令进行管理操作。实际证明这样走不通的请你放弃幻想。跟着这个教程一步一步的操作你大概率是可以成功的。我会尽可能的详细一步一步足够缓慢足够让每个第一次安装的朋友都能够明白。感谢北京师范大学地理学院的朋友提供的帮助我将把这个方法详细记录希望可以帮助到更多朋友。个人电脑配置说明OSWindows 11 EnterpriseMacOS和Linux的朋友建议拉到文末采用Conda指令安装Version25H2 Win10已停止维护尽可能系统升级Win11则不在乎具体版本22H223H224H225H2全都行Compile ArchitectureAMD64划重点待会儿要用IDECursor 3.19.14PyCharmCondaVSCode等所有国产IDE都是可以的TerminalCmd这是系统自带的不需要下载每个人电脑自带BroswerChrome Version 152.0.7977.82 (Official Build) (64-bit) (能打开网页就行)PythonVersion 3.13.15 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.15的版本各位朋友可以看看自己的。不是非要和我一样才行你的3.10或者3.11或者其他版本都是可以的。MSC v.1944 64 bit (AMD64): 这是编译器的信息表示这个Python解释器是用Microsoft Visual C (MSC) 编译器的1944版本编译的支持64位AMD64架构。支持AMD64的意思就是和ARM区分和32位区分GDAL版本众多要选择符合当前电脑的。有的人是32位的有的人是ARM架构的反正你得先知道自己电脑的版本。第二步去下载安装文件最新GDAL下载网址https://github.com/cgohlke/geospatial-wheels/releases我默认你是可以打开Github类的网页有疑问或打不开可以在站内查询攻略很可能没有展示完毕再点一下全部展开根据自己电脑的python版本编译架构下载相适配的版本。于我而言我该下载gdal-3.13.3-cp313-cp313-win_amd64.whl点击下载适合自己电脑和Python版本的GDAL文件保存到电脑桌面上。Github文件下载速度太慢的朋友考虑站内搜索加速办法我默认你会我现在回答一下有的朋友问我的Python是3.9或3.8的老版本这里没有啊怎么办答案在这个网页往下继续翻阅资源在以前的更新中一个一个点开Assets总会有你需要的版本。还有朋友问最近出新版本的GDAL包了我该如何更新答案能不更新就不更新除非你的版本已经不能用了。必须采取新版本的新功能满足我当前的工程需要此时你才需要更新平时没有那么多功能用得上。更新的套路就是卸载旧版本后确保能够适配的新版本情况下下载并安装。如何卸载 文章后面会讲卸载倒是很easy第三步找到正确的安装路径我们需要找到Python软件中名为“Scripts”的文件夹路径。很多朋友找不到这个文件夹在哪其他攻略也没写我来“好为人师”一次就当献丑了。和刚才一样按下winR打开cmd终端首先输入输入完按回车python紧接着输入输入完按回车import sys最后输入输入完按回车print(sys.path)找到这个带有roaming和site-packages将是你的安装路径C:\\Users\\IU\\AppData\\Roaming\\Python\\Python313\\site-packages第四步在安装路径放入文件按住win E 在文件夹中根据名称一步一步找到它的位置速度快只需要30妙。我个人会采用这个方法我比较传统当然还有一种简便方法就是打开记事本编辑一下路径然后粘贴到位。好朋友提供的办法在桌面上将下载好的GDAL包拖动到指定的内。完成后那儿也不要去就在当前在路径框内输入CMD。像我这样操作就好了很简单。第五步输入正确的安装指令按下回车↩️的效果是这样的你需要看到类似的。最后只需要简单的输入指令pip install gdal-3.13.3-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.4-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 DLLGDAL 是一个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 documentationGitHub - OSGeo/gdal: GDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.
2026！在Windows的Python中安装GDAL包（小白能成！）
最近更新2026.08.18日GDAL 3.13.3 发布更新新版本以修复bug为主提高稳定性有朋友催我赶紧更新教程我上次更新是2月份的时候了。前言很多大气地理环境生态遥感城市空间规划等专业的朋友在各种终端尝试pip install GDAL指令时都会遇到各种各样奇怪的报错无论如何都安不上。说实话这条路走不通不怪你。因为GDAL不是标准的python库不能直接用pip指令进行管理操作。实际证明这样走不通的请你放弃幻想。跟着这个教程一步一步的操作你大概率是可以成功的。我会尽可能的详细一步一步足够缓慢足够让每个第一次安装的朋友都能够明白。感谢北京师范大学地理学院的朋友提供的帮助我将把这个方法详细记录希望可以帮助到更多朋友。个人电脑配置说明OSWindows 11 EnterpriseMacOS和Linux的朋友建议拉到文末采用Conda指令安装Version25H2 Win10已停止维护尽可能系统升级Win11则不在乎具体版本22H223H224H225H2全都行Compile ArchitectureAMD64划重点待会儿要用IDECursor 3.19.14PyCharmCondaVSCode等所有国产IDE都是可以的TerminalCmd这是系统自带的不需要下载每个人电脑自带BroswerChrome Version 152.0.7977.82 (Official Build) (64-bit) (能打开网页就行)PythonVersion 3.13.15 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.15的版本各位朋友可以看看自己的。不是非要和我一样才行你的3.10或者3.11或者其他版本都是可以的。MSC v.1944 64 bit (AMD64): 这是编译器的信息表示这个Python解释器是用Microsoft Visual C (MSC) 编译器的1944版本编译的支持64位AMD64架构。支持AMD64的意思就是和ARM区分和32位区分GDAL版本众多要选择符合当前电脑的。有的人是32位的有的人是ARM架构的反正你得先知道自己电脑的版本。第二步去下载安装文件最新GDAL下载网址https://github.com/cgohlke/geospatial-wheels/releases我默认你是可以打开Github类的网页有疑问或打不开可以在站内查询攻略很可能没有展示完毕再点一下全部展开根据自己电脑的python版本编译架构下载相适配的版本。于我而言我该下载gdal-3.13.3-cp313-cp313-win_amd64.whl点击下载适合自己电脑和Python版本的GDAL文件保存到电脑桌面上。Github文件下载速度太慢的朋友考虑站内搜索加速办法我默认你会我现在回答一下有的朋友问我的Python是3.9或3.8的老版本这里没有啊怎么办答案在这个网页往下继续翻阅资源在以前的更新中一个一个点开Assets总会有你需要的版本。还有朋友问最近出新版本的GDAL包了我该如何更新答案能不更新就不更新除非你的版本已经不能用了。必须采取新版本的新功能满足我当前的工程需要此时你才需要更新平时没有那么多功能用得上。更新的套路就是卸载旧版本后确保能够适配的新版本情况下下载并安装。如何卸载 文章后面会讲卸载倒是很easy第三步找到正确的安装路径我们需要找到Python软件中名为“Scripts”的文件夹路径。很多朋友找不到这个文件夹在哪其他攻略也没写我来“好为人师”一次就当献丑了。和刚才一样按下winR打开cmd终端首先输入输入完按回车python紧接着输入输入完按回车import sys最后输入输入完按回车print(sys.path)找到这个带有roaming和site-packages将是你的安装路径C:\\Users\\IU\\AppData\\Roaming\\Python\\Python313\\site-packages第四步在安装路径放入文件按住win E 在文件夹中根据名称一步一步找到它的位置速度快只需要30妙。我个人会采用这个方法我比较传统当然还有一种简便方法就是打开记事本编辑一下路径然后粘贴到位。好朋友提供的办法在桌面上将下载好的GDAL包拖动到指定的内。完成后那儿也不要去就在当前在路径框内输入CMD。像我这样操作就好了很简单。第五步输入正确的安装指令按下回车↩️的效果是这样的你需要看到类似的。最后只需要简单的输入指令pip install gdal-3.13.3-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.4-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 DLLGDAL 是一个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 documentationGitHub - OSGeo/gdal: GDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.
