简介面向Python 2.7用户在Win7 64位平台安装GDAL的完整实操记录适合GIS、遥感领域需要搭建GDAL Python开发环境的初学者参考。文档围绕两种安装路线展开一是通过GDAL core自带swig/python进行编译安装二是直接下载官方msi文件快速安装均给出具体命令、依赖环境说明与配置步骤并重点剖析了常见的swig.exe未安装、VS2010环境变量缺失、ImportError DLL load failed等报错原因及对应解决方案。资源为单个docx文档约95KB内容精炼、按问题分节附有环境需求清单Visual Studio 2010、GEOS、Python 2.7和错误附录便于按图索骥排查环境问题。已有628人学习该文档适合在配置GDAL 1.9.2/1.11.0并配合Python 2.7时参考可显著缩短环境搭建与排错时间。1. 折腾两天装 GDAL最后输给一个环境变量这个标题不是夸张是真实过程。为了在 Python2.7 里用上 GDAL我在 Win7 64 位机器上整整折腾了两天撞上了 swig 未安装、Vcvarsall.bat 找不到、DLL load failed 三座大山。最后真正卡住我的居然只是 GDAL 的 bin 目录没加进环境变量 Path——一行配置的事硬是让我怀疑了一晚上人生。下面把我走过的两条路用 core 源码自编译 swig/python以及直接装官方 msi完整拆开每个报错长什么样、为什么触发、怎么解决都写清楚。给正在 Win7 64 位 Python2.7 上装 GDAL 的同学一份能直接照着走的作业也给后来人省点排查时间。2. 装 GDAL 前先想清楚编译路线还是 msi 路线2.1 环境清单版本对齐是第一优先级先亮出我的环境没对齐版本之前的一切尝试说玄学都算客气操作系统Win7 SP1 64 位编译器VS2010对应环境变量是 VS100COMNTOOLSGDALcore 版 1.9.2后来也尝试过 1.11.0安装步骤通用GEOS3.3.8GDAL 做几何运算时的依赖库Python2.7注意我装的是 32 位版本安装目录在 Program Files (x86)这里有个新手最容易忽略的隐性条件Python 2.7 时代很多同学在 64 位系统上装的却是 32 位 Python因为当时大量第三方扩展库只提供 32 位编译版本。GDAL 的 msi 安装包和源码编译产物都有位数之分Python、GDAL、编译器三者的位数必须对齐否则 import 阶段会看到各种莫名其妙的 DLL 报错而且报错信息完全不会提示位数问题非常坑。版本方面多说一句。我最初直接上 GDAL 1.11.0报错后能搜到的排查资料少换回 1.9.2 后网上的解决办法明显变多毕竟老版本用户基数大、踩坑记录全。Windows 平台装 GDAL我的体会是别追新优先用资料多的版本。1.9.2 和 1.11.0 的安装流程几乎一致核心 DLL 文件名不同而已前者是 gdal192.dll后者是 gdal111.dll环境变量配置思路完全相同。2.2 两条路线怎么选一张表说清楚两条路我都实际跑过先给结论表再展开讲路线上手难度出错概率适合的人主要收获core 源码 swig 自编译高高想摸清 GDAL 内部结构的人能看懂调用链与 DLL 依赖关系官方 msi 一键安装低低只打算用 GDAL 干活的人省时间但出问题难定位给个决策建议如果只是要在 Python 里读栅格、做投影转换、跑栅格计算直接走 msi 路线别为了显得专业去编译源码。我当时想着 VS2010 反正已经装了不如把 core 代码也研究一下顺手查看了 apps 目录下的 gdalinfo.cpp大致搞明白了 GDAL 读取数据的流程先构造 GDALDataset再按波段调用 RasterIO 读写像素最后 Close 释放。这个理解对后面调试 import 报错有帮助因为你至少知道 Python 端的 gdal.Open 最终会走到 C 的 GDALOpen中间靠 swig 生成的包装代码和 _gdal 扩展模块搭桥。代价同样真实编译路线整整多花了一天半的排错时间而且每一步报错都和环境强相关换一台机器可能报错长得不一样。时间紧、目标明确的同学msi 路线二十分钟内搞定。两条都试完我更推荐的顺序是先用 msi 把环境跑通再回头研究源码顺序反了很容易劝退。2.3 理解 bin 目录和 Path两条路线共同的终点其实两条路线最后都会撞上同一个问题Python 找不到 gdal192.dll。这个核心动态库无论编译还是 msi 安装都会落在 GDAL 的 bin 目录下。Windows 下 Python 加载 _gdal.pyd 扩展时会按当前目录、系统目录、Path 环境变量这个顺序去搜索依赖的 DLL而 gdal192.dll 不在其中任何一层于是报 DLL load failed。所以我把这条放在最前面讲装完 GDAL 的第一件事就是把 bin 目录加进系统环境变量 Path而不是等报错了再去补。这个动作在两条路线里都是必须的不做的话无论你怎么编译、怎么安装import gdal 这一关永远过不去。后面两章分别把两条路线的操作还原出来每一步的报错都按我实际遇到的顺序写。2.4 安装顺序GEOS 必须排在 GDAL 前面依赖顺序上VS2010 和 GEOS 3.3.8 要在 GDAL 之前装好。GEOS 是 GDAL 做空间运算要链接的库如果后装编译时可能链不上运行期也可能因为缺 geos_c.dll 而崩溃。这里有个比 DLL load failed 更隐蔽的现象GEOS 没进 Path 时import 可能正常但一调用空间分析函数就崩报错点跟安装无关很难往环境变量上想。所以我在检查 Path 时习惯把 GDAL 和 GEOS 两个 bin 目录一起加进去宁可多配一条不留暗病。3. 编译路线实战从 core 源码到 Python 绑定的完整步骤3.1 第一步用 VS2010 的 X64 命令提示符进入 swig 目录编译 GDAL 的 Python 绑定必须在 VS 的命令行工具里做普通 cmd 不行因为它没有预置编译器相关环境变量。我当时用的入口是开始菜单里找到 VS2010 的 Visual Studio 工具选 X64 兼容工具命令提示符右键管理员身份运行。选 X64 而不是 X86跟位数要求直接相关选错的话 nmake 阶段可能没事setup.py 阶段会冒出别的链接错。cd C:\OGC\GDAL192\gdal-1.9.2\swig nmake /f makefile.vc python拆开解释这条命令nmake 是 VS 自带的 make 工具/f makefile.vc指定使用 swig 目录下这个 makefile最后的python是目标名让 makefile 执行生成 Python 绑定文件的相关规则。这一步会先写 setup.ini再调用 swig 把 gdalconst.i、gdal.i 这些接口定义文件转成 C 包装代码输出到 extensions 目录和 osgeo 目录下。3.2 第一个坑swig.exe 找不到第一次跑这条命令终端直接终止报错内容如下swig.exe 不是内部或外部命令也不是可运行的程序或批处理文件。 NMAKE : fatal error U1077: “swig.exe”: 返回代码“0x1”原因很直接GDAL 的 swig 目录里只有接口描述文件真正把 C/C 接口转成 Python 绑定代码的 swig.exe 是独立工具机器上没装。解决方法是下载 swig 2.10.0解压到固定目录把 swig.exe 所在目录加进系统环境变量 Path。这里有两个注意点第一改完 Path 必须重新打开命令提示符环境变量只在进程启动时读一次旧窗口不会自动刷新第二建议加系统环境变量而不是用户环境变量虽然用户变量也够用但系统变量能让所有进程统一继承排查时少一层变量覆盖的干扰。我第一次就是没重开窗口又多跑了一轮。3.3 第二步setup.py 与 Vcvarsall.bat 的经典骗局nmake 跑通后继续编译安装 Python 绑定cd python Python setup.py build Python setup.py install这一步会撞上第二个经典报错unable to find Vcvarsall.bat网上流传的 mingw 方案我也翻过车不是库环境对不上就是链接参数冲突。最后用的是取巧办法在同一个命令行窗口先执行set VS90COMNTOOLS%VS100COMNTOOLS%原理是这样的Python 2.7 的 setup.py 找编译器时按 VS2008 的规则去查对应环境变量是 VS90COMNTOOLS而机器上只有 VS2010对应的是 VS100COMNTOOLS。这一行命令把 VS2010 的工具路径复制到旧变量名上让 setup.py 在预期位置找到 Vcvarsall.bat。执行完重新 build 和 install会刷出一堆输出里面有警告也有非致命错误不用管它。判断成功的标准只有一个检查 site-packages 下是否生成了 gdal.py、osgeo 目录和 _gdal 相关的 pyd 文件文件在这一步就算过了。提示set 命令只对当前窗口生效。中途关了窗口必须重新执行一遍否则 setup.py 又会报找不到 Vcvarsall.bat。3.4 第三步 import gdalDLL load failed 的真相编译安装都完成后在命令行敲python -c import gdal结果ImportError: DLL load failed: 找不到指定的模块。报错堆栈指向 osgeo 目录的init.py位置在 swig_import_helper 里加载 _gdal 扩展时。这是整个安装过程里最磨人的一个错它不在编译阶段出现也不在安装阶段出现只在运行时要炸一下而且信息极短根本不告诉你是缺哪个模块像一只黑匣子。网上很多方案都指向各种重装我弯路走了不少最后发现就是 GDAL 的 bin 目录没进 PathPython 加载 _gdal 扩展时需要 gdal192.dll而这个 DLL 不在搜索路径里。解决就一步把 GDAL 安装目录下的 bin 目录加进 Path重开命令行再 import。注意核对路径层级bin 目录里要能直接看到 gdal192.dll 这个文件。如果用的是 GDAL 1.11.0文件名换成 gdal111.dll配置思路一样但确认文件名要按实际版本。3.5 编译路线的额外收获看懂调用链回头看不亏的部分是查看 apps 目录下的 gdalinfo.cpp 时理清了读取流程gdalinfo 的主函数先调用 GDALOpen 构造数据集判断文件能否打开再遍历栅格波段读取尺寸、投影和地理信息。这个 C 流程和 Python 端的 gdal.Open 完全对应Python 只是经 swig 包装后调用同一套 C API。理解这条调用链后遇到 Python 能 import 但打不开文件的问题至少知道往数据格式、驱动注册这个方向查而不是盯着 import 那行报错发呆。4. msi 路线最省事但 DLL 的坑一个都躲不掉4.1 官方 msi 的选择与安装第二条路线简单很多去官网下载对应版本的 msi 安装包按 Python 的位数选择位数双击一路下一步。下载页面会列出多个文件命名里通常带版本号和位数信息对应 Python2.7 的那个版本文件名里一般也能看出来。Python 是 32 位就装 32 位 msiPython 是 64 位就找 64 位 msi交叉安装的结果就是 import 时直接 DLL load failed报错和位数问题长得一模一样迷惑性极强。msi 默认装到类似 C:\Program Files\GDAL192 的目录里面有 bin、lib、include 和 Python 绑定文件。bin 目录放的是 gdal192.dll 这类核心动态库Python 绑定文件会装到 Python27 的 site-packages 下。路径带空格这件事值得注意在环境变量里加路径时没问题但如果用 setx 写 Path 拼接命令空格可能截断字符串导致路径没写全回头怎么找都找不到原因。装的时候如果自定义了安装路径一定先记下来后面加环境变量要用。4.2 装完照样报 DLL 错同一个坑的两种解法重点来了msi 装完直接 import gdal照样报ImportError: DLL load failed: 找不到指定的模块。跟编译路线最后一步的报错一模一样。这说明这个坑与安装方式无关是 Windows 运行时 DLL 搜索机制的固有行为两条路线都躲不掉。解决方案也算统一把 bin 目录加进 Path。先给一个临时验证的思路不动系统设置在当前窗口跑# 临时追加 bin 目录只对当前窗口生效 set Path%Path%;C:\Program Files\GDAL192\bin python -c import gdal如果这样能过说明判断正确再去持久化。持久化有两种写法用 setx 的命令行方式以及系统图形界面手动追加setx Path %Path%;C:\Program Files\GDAL192\binsetx 会写入注册表持久生效但它读取的是当前会话的 Path 值再整体写回如果当前会话的 Path 不是最新状态存在覆盖丢失其他条目的风险。更稳妥的是走图形界面右键我的电脑 → 属性 → 高级系统设置 → 环境变量 → 编辑 Path → 新建一行填 bin 路径。改完老规矩所有命令行窗口和 IDE 全部重开。还有一类情况要区分msi 装完 import 报的不是 DLL 错而是提示找不到 gdal 模块那要检查 msi 的 Python 绑定选项是否安装到位以及 Python 位数和 msi 位数是否一致。这类错在编译路线里很少见因为编译安装会把文件直接放到 site-packagesmsi 则依赖安装选项容易被忽略。另外如果换了 Python 位数bin 目录里对应位数的 DLL 也要重新匹配混用基本都会在 import 阶段露馅。4.3 两条路线殊途同归的结论把两条路线跑完结论很清楚编译路线的难点在前半程集中在工具链和环境变量msi 路线的难点只有后半程就是 DLL 搜索。而 bin 目录加 Path 这一步是两条路线共同的必经环节。如果只是要用 GDAL 干活直接 msi 加 Path 就完事如果想理解 GDAL 的结构和依赖关系再回头走编译路线这时候你会知道每一步在干什么而不是机械复制命令。5. 避坑清单五条让我耗掉一整天的排错记录5.1 swig.exe 不是内部或外部命令现象nmake 执行到 swig 处直接终止提示找不到命令附带 NMAKE fatal error U1077。原因swig 独立工具没装或者装了但目录没加进 Pathmake 工具在进程环境里找不到这个可执行文件。解决下载 swig 2.10.0解压到固定目录把 swig.exe 所在目录加入 Path。加完之后强制重开命令提示符别偷懒。也不建议把 swig.exe 直接复制进系统目录污染系统不说以后升级版本容易冲突而且排查时还会干扰你对真实 Path 的判断。5.2 unable to find Vcvarsall.bat现象Python setup.py build 时找不到编译器配置脚本安装直接中断。原因Python 2.7 的 setup.py 默认按 VS2008 查找编译环境机器上装的是 VS2010环境变量名对不上导致 Vcvarsall.bat 的定位逻辑失效。解决执行set VS90COMNTOOLS%VS100COMNTOOLS%后再 build。注意 set 只在当前窗口有效换窗口要重新执行。如果以后换了大版本 Python这类变量名兼容问题会以别的形式出现排查思路一样看看 setup.py 到底在查哪个变量顺着变量名去补环境变量。5.3 DLL load failed: 找不到指定的模块现象import gdal 报 DLL 加载失败堆栈指向 osgeo 目录的init.py位置在 swig_import_helper 加载 _gdal 时。原因Python 加载 _gdal 扩展时依赖的 gdal192.dll 不在 DLL 搜索路径里扩展模块加载失败但报错不告诉你缺的具体文件名。解决把 GDAL 的 bin 目录加进 Path重开命令行。排查时先确认 bin 路径真实存在再确认 gdal192.dll 确实在里面别凭记忆写路径。GDAL 1.11.0 对应的是 gdal111.dll文件名不一样。如果加完还报检查是不是 32/64 位混用用 platform.architecture() 确认 Python 位数再去核对 DLL 位数。5.4 改了环境变量不生效现象Path 明明加过了重开窗口还是报原来的错。原因环境变量改动只对之后新建的进程生效旧窗口、旧 IDE、旧进程全部继承旧值你看到的还是改动前的环境。解决把所有命令行窗口、Python IDE 全部关掉再重开。在 IDE 里跑代码的人最容易踩这个坑IDE 启动于改环境变量之前哪怕你在 IDE 里打开新终端继承的仍是 IDE 进程的环境必须整体退出 IDE 再启动。5.5 安装过程一堆提示以为失败了现象setup.py build 和 install 刷屏里面夹杂警告甚至非致命错误误以为失败反复重装。原因GDAL 绑定的编译过程输出大量诊断信息多数不影响最终产物属于正常噪音。解决以结果为准。检查 site-packages 下是否有 gdal.py、osgeo 目录和 _gdal 扩展文件。文件在就继续下一步测试不用管中间输出。我最初被这些提示吓住反复重装了好几遍纯属自己吓自己浪费了整晚时间。6. 最后验证三行命令确认 GDAL 真能用安装完成不等于能用我的标准动作是写一个验证脚本跑三件事# -*- coding: utf-8 -*- import gdal # 导入 GDAL Python 绑定确认模块可加载 print(gdal.VersionInfo()) # 打印版本号确认核心库版本对得上 from osgeo import gdal # 换一种导入路径确认包结构完整 ds gdal.Open(d:/tmp/test.tif) # 打开真实栅格文件触发驱动注册 print(ds.RasterXSize, ds.RasterYSize) # 输出行列数验证读取链路通 from osgeo.gdalconst import GA_ReadOnly # 确认常量模块正常后续读写要用第一段确认模块能加载、版本对得上第二段打开一个真实栅格文件真正走一遍 GDALOpen 到数据集构造的流程第三段确认常量模块正常。三条全过才算真正装完。很多时候 import 能过但 Open 一读就崩那多半是依赖链还有缺口比如 GEOS 的 DLL 没在 Path 里这类问题依然从 bin 目录排查起不要动 Python 或者重装。复盘这次安装最大的教训是GDAL 在 Windows 上装好和能用是两件事编译成功不意味着运行时没问题msi 安装成功同样不意味着运行时没问题。从那以后我每次装完 GDAL 都强制自己走一遍环境变量检查加这套验证脚本两分钟的事换掉的是几小时的血压。希望这篇记录能帮你在 Win7 64 位 Python2.7 的组合上少走弯路一次装通。本文还有配套的精品资源点击获取