Win10 Jupyter安装GDAL报subprocess-exited-with-error错误如何解决

这个报错的核心原因是pip默认拉取GDAL源码在本地编译时失败，Windows缺少GDAL依赖的C/C++编译链、底层地理空间依赖库，或是版本不匹配都会触发这个问题，按以下步骤排查修复即可：

第一步：先确认环境匹配信息 #

先在Jupyter Notebook的单元格中运行以下命令，记录当前内核使用的Python版本、系统架构：

import sys, platform
print("Python版本:", sys.version)
print("系统架构:", platform.architecture())

重点记清楚Python的大版本（比如3.9/3.10/3.11）、是32位还是64位系统，后续安装包必须和这两个信息严格对应，否则大概率安装失败。

第二步：优先选择无需本地编译的安装方式 #

不要直接运行pip install gdal走源码编译流程，选以下任意一种预编译安装方式，成功率最高：

方式1：conda源安装（Anaconda/Miniconda环境首选） #

1. 打开Anaconda Prompt，激活Jupyter Notebook使用的对应虚拟环境
2. 执行命令安装GDAL，conda会自动匹配版本，同时安装GDAL依赖的GEOS、PROJ、C++运行库等所有底层组件：

conda install gdal -y

3. 安装完成后执行python -c "from osgeo import gdal; print(gdal.__version__)"，能正常输出版本号即安装成功。

方式2：手动安装预编译whl包 #

1. 提前下载和你刚才查到的Python版本、系统架构完全匹配的GDAL预编译wheel包，包名里的cp3xx标识要对应Python版本，win_amd64对应64位系统，win32对应32位系统。
2. 打开命令行激活对应虚拟环境，切换到whl包存放的目录，执行安装命令：

pip install 下载的GDAL whl包完整文件名.whl

第三步：常见踩坑排查 #

• 重装前先清理之前安装失败的残留文件：执行pip uninstall gdal -y清除旧版本，避免pip/conda混装导致的依赖冲突
• 安装完成后Jupyter导入报错的话，先重启Jupyter内核，新安装的包需要重启内核才能加载
• 如果导入时提示缺少DLL文件，找到GDAL安装目录下的bin文件夹，把完整路径加到系统环境变量PATH中，重启Jupyter即可
• 不要在过新的Python版本上装过旧的GDAL版本，比如Python3.12及以上版本最低要适配GDAL3.6以上版本，否则没有对应预编译包还是会触发编译失败

内容的提问来源于stack exchange，提问作者Harshita Garg