简介这份文档面向在 Win7 64 位环境下使用 Python 2.7 的开发者聚焦 GDAL 地理空间库的安装与配置难题适合刚接触 GIS 开发、需要在旧版 Windows 平台搭建 Python 空间数据处理环境的技术人员参考。资源包内仅含 1 个 docx 文档体积约 95KB以文字记录为主便于快速查阅与本地留存。文档围绕 GDAL 1.9.2 与 Python 2.7 的搭配展开梳理了 Visual Studio 2010、GEOS 3.3.8 等依赖项的安装顺序并对比了自行编译 swig/python 与直接安装官方 msi 两种方案同时给出 swig.exe 缺失、Vcvarsall.bat 找不到、DLL load failed 等典型报错的排查思路与环境变量配置要点。目前已有 627 人学习下载适合希望少走弯路、快速完成 GDAL 环境搭建的读者参考借鉴。1. 为什么 Win7 64 位 Python2.7 装 GDAL 至今仍是高频翻车现场如果你手上有一台还在跑 Win7 64 位的工控机、老测绘笔记本或者某个只认 Python2.7 的遗留遥感脚本那你大概率会在装 GDAL 这一步卡住。GDAL 不是纯 Python 包它底层是 C/C 编译出来的动态库Python 这边只是一个绑定壳。pip 直接装会去编译源码而 Win7 上没有现成的编译环境于是报错、缺 DLL、版本对不上轮番上阵。更麻烦的是 Python2.7 已经停止维护很多新版的 GDAL wheel 根本不再提供 cp27 的包你得去找历史版本还得保证位数、编译器、numpy 版本全部对齐。这篇笔记就是把我自己在几台 Win7 64 位机器上反复装 GDAL 的路径拆开讲清楚从判断该用哪种安装方式到具体命令、环境变量、DLL 排查再到装完之后怎么验证。目标很直接——让你少走我当年走过的弯路一次把环境跑通。2. 先搞清楚 GDAL 在 Windows 上到底怎么装才不翻车2.1 三种安装路径的适用边界在 Win7 64 位 Python2.7 这个组合下装 GDAL 常见有三条路选错了后面全是坑。第一条是 pip 源码编译。执行pip install GDAL时pip 会下载源码包并尝试用本机的 C 编译器编译。Win7 上如果没有装 Visual Studio 2008 或对应的 Windows SDK这一步直接失败报错通常是Unable to find vcvarsall.bat。即便装了编译器GDAL 依赖的 PROJ、GEOS 等库也要手动配好对只想跑脚本的人来说成本太高。这条路我不推荐。第二条是找第三方预编译的 wheel 文件。这是 Win7 Python2.7 最现实的做法。wheel 里已经包含了编译好的_gdal.pyd和配套 DLLpip 只负责解压安装不触发编译。关键在于 wheel 的命名要和你本机环境严格匹配比如GDAL-2.4.4-cp27-cp27m-win_amd64.whl其中cp27表示 CPython2.7win_amd64表示 64 位 Windows。位数不对、Python 小版本不对装了也 import 不了。第三条是用 conda 安装。如果你的机器上装了 Anaconda 或 Minicondaconda install gdal会自动解决依赖。但 Win7 上较新的 conda 版本可能已经不支持需要退到老版本。而且 conda 环境里的 Python 版本要和你脚本要求的一致否则会出现“命令行能 import、IDE 里不能”的玄学问题。我一般会先确认两件事Python 是不是 64 位以及 pip 能不能正常联网。确认命令后面会讲。只要这两点没问题就走 wheel 路线。2.2 确认你的 Python 位数和 pip 状态动手之前先把环境摸清楚别急着下载。打开 cmd依次执行python -c import struct; print(struct.calcsize(P) * 8)这行代码输出64说明是 64 位 Python输出32就是 32 位。Win7 64 位系统上完全可以装 32 位 Python所以这一步必须确认不能想当然。接着看 pip 版本和 Python 版本python --version pip --versionpython --version应该输出Python 2.7.x。pip --version会显示 pip 版本以及它关联的 Python 路径确认这个路径就是你打算装 GDAL 的那个 Python。如果机器上有多个 Python很容易装到另一个环境里去后面 import 报ImportError就是这里埋的雷。提示如果 pip 版本太老先升级 pip 本身。Python2.7 对应的 pip 最高一般停在 20.x执行python -m pip install --upgrade pip21即可不要强行装新版 pip会不兼容。2.3 找到匹配 cp27 的 GDAL wheelwheel 文件的核心是命名规则。以GDAL-2.4.4-cp27-cp27m-win_amd64.whl为例拆开看字段含义你必须匹配的点GDAL-2.4.4包名和版本按脚本需求选别盲目追新cp27CPython 2.7必须和你的 Python 主版本一致cp27mABI 标签Python2.7 一般是 cp27mwin_amd64平台64 位 Python 用这个32 位用 win32选版本时有个血泪经验不是越新越好。GDAL 2.4.x 对 Python2.7 的支持比较完整再往上的版本很多只发 cp36 以上的 wheel。如果你脚本里用了osgeo的老接口还要注意 GDAL 大版本变化带来的 API 差异。我一般会先看脚本里from osgeo import gdal之后调了哪些方法再决定装 2.3 还是 2.4。下载 wheel 时注意别下成源码包.tar.gz那个装起来就是前面说的编译路线。文件下好后放到一个路径简单、没有中文和空格的目录比如D:\gdal_whl\路径里有中文有时会让 pip 解析出问题。2.4 用 pip 安装 wheel 并验证 import进入 wheel 所在目录执行安装cd /d D:\gdal_whl pip install GDAL-2.4.4-cp27-cp27m-win_amd64.whlcd /d是 Windows 下切换盘符和目录的写法不加/d切不到 D 盘。安装过程如果顺利最后会显示Successfully installed GDAL-2.4.4。装完立刻验证别等到跑脚本时才发现问题# verify_gdal.py from osgeo import gdal print(gdal.__version__) dataset gdal.Open(test.tif) if dataset is None: print(open failed) else: print(dataset.RasterXSize, dataset.RasterYSize)这段代码先打印 GDAL 版本再尝试打开一个测试影像。gdal.Open返回None表示打开失败可能是文件路径不对或格式不支持但至少说明 GDAL 本身已经能 import。如果第一行from osgeo import gdal就报错那问题出在安装环节继续往下看排查章节。参数说明gdal.Open的第一个参数是文件路径Win7 下建议用原始字符串或正斜杠避免反斜杠被当转义符。RasterXSize和RasterYSize是影像的宽高像素数能打印出来就说明数据驱动正常加载了。3. 环境变量与 DLL 依赖装完 import 报错的根因排查3.1 PATH 里到底该加哪些目录wheel 安装后_gdal.pyd和一堆 DLL 会被放到site-packages\osgeo目录下。Python 在 import 时会去这个目录找_gdal.pyd但_gdal.pyd本身还依赖同目录下的其他 DLL比如gdal204.dll。如果这些 DLL 不在系统搜索路径里就会报DLL load failed。常见做法是把osgeo目录加到系统 PATH。假设你的 Python 装在C:\Python27那目录就是C:\Python27\Lib\site-packages\osgeo加到 PATH 后需要重开 cmd 才生效。验证方法是echo %PATH%看输出里有没有包含 osgeo 路径。注意 PATH 里不要有重复项也不要塞太多无关路径Win7 的 PATH 长度有限制超了会截断反而引发更奇怪的问题。3.2 用 Dependency Walker 定位缺失的 DLL如果加了 PATH 还是报 DLL 加载失败就需要看看到底缺哪个。老牌工具 Dependency Walker 可以打开_gdal.pyd它会列出所有依赖的 DLL缺失的会用红色标出。Win7 上常见的缺失项是MSVCR90.dll、MSVCP90.dll这类 VC 运行库。解决办法是装对应的 Visual C Redistributable。Python2.7 本身是用 VS2008 编译的所以需要 VC 2008 运行库。注意 64 位 Python 要装 64 位的运行库装成 32 位的不起作用。这个运行库在微软官网能下到装完重启一次再试。注意不要随便从网上单独下载某个 DLL 丢到 system32 里版本不匹配会导致更严重的系统问题。优先用官方运行库安装包。3.3 numpy 版本冲突导致的隐性失败GDAL 的 Python 绑定在部分功能上依赖 numpy尤其是读写栅格为数组时。如果 numpy 版本和 GDAL wheel 编译时用的版本差异太大可能在 import 阶段就报错错误信息往往很隐晦比如ImportError: numpy.core.multiarray failed to import。Python2.7 对应的 numpy 最后稳定版本大概在 1.16.x。我一般会先固定 numpypip install numpy1.16.6然后再装 GDAL wheel。顺序很重要先 numpy 后 GDAL因为 GDAL 安装时可能会检查 numpy 是否存在。如果先装了 GDAL 再降 numpy有时需要重装 GDAL 才能重新链接。3.4 一个最小可复现的验证脚本把前面的验证脚本再补全一点加上数组读取能同时验证 GDAL 和 numpy 的配合# verify_gdal_numpy.py from osgeo import gdal import numpy as np ds gdal.Open(test.tif) band ds.GetRasterBand(1) arr band.ReadAsArray() print(shape:, arr.shape) print(dtype:, arr.dtype) print(mean:, np.mean(arr))GetRasterBand(1)取第一个波段ReadAsArray()把波段读成 numpy 数组。如果这一步能打印出 shape 和均值说明 GDAL、DLL、numpy 三者都正常。arr.shape是行数列数dtype常见是uint8或uint16取决于影像位深。均值能算出来说明 numpy 运算也通了。4. 避坑指南Win7 64 位装 GDAL 最常见的 5 个翻车点4.1 现象pip 报 “is not a supported wheel on this platform”原因wheel 文件名里的平台标签和本机 Python 不匹配。最常见的是 32 位 Python 装了win_amd64的包或者 Python 是 2.7.9 而 wheel 要求 cp27m 但实际 ABI 有差异。解决先用 2.2 节的命令确认位数再核对 wheel 文件名。如果位数对但还是报错执行pip debug --verbose老版本 pip 可能不支持或直接看python -c import pip; print(pip.pep425tags.get_supported())把支持的标签和 wheel 文件名逐段比对。4.2 现象import osgeo 报 “DLL load failed: 找不到指定的模块”原因_gdal.pyd依赖的某个 DLL 不在搜索路径里或者 VC 运行库缺失。解决先加 osgeo 目录到 PATH重开 cmd。还不行就用 Dependency Walker 看缺哪个 DLL补装 VC 2008 运行库。注意 64 位和 32 位运行库不能混装。4.3 现象装完 GDAL 后 numpy 报错或反过来原因numpy 和 GDAL 的编译版本不匹配或者安装顺序导致链接错误。解决先卸掉两个包按“先 numpy 后 GDAL”的顺序重装numpy 固定在 1.16.6 附近。卸载命令是pip uninstall GDAL numpy然后重新执行安装。4.4 现象命令行能 importPyCharm 或 IDE 里不能原因IDE 用的解释器和你命令行里的不是同一个或者 IDE 没有继承系统 PATH。解决在 IDE 的项目设置里确认解释器路径指向你装 GDAL 的那个 python.exe。如果 IDE 有自己的环境变量配置把 osgeo 目录也加进去。最省事的办法是直接在 IDE 的终端里跑一遍验证脚本看报错是否一致。4.5 现象gdal.Open 返回 None但 import 正常原因这不是安装问题是数据或路径问题。可能是文件路径含中文、文件被占用、或者格式驱动没加载。解决先用绝对路径和英文文件名测试。如果还不行用gdal.GetDriverCount()看驱动数量正常应该有几十个。驱动数为 0 说明 GDAL 数据目录没配好需要设置GDAL_DATA环境变量指向site-packages\osgeo\data\gdal。5. 装好之后怎么确认真的能用三个进阶验证技巧5.1 用 gdalinfo 命令行工具做交叉验证wheel 安装通常会带gdalinfo.exe在site-packages\osgeo目录下。直接命令行调用C:\Python27\Lib\site-packages\osgeo\gdalinfo.exe test.tif如果这个工具能输出影像的坐标系、波段数、范围等信息说明 GDAL 的 C 层完全正常。Python 层再出问题就只可能是绑定或环境变量的事。这个交叉验证能帮你快速缩小排查范围。5.2 检查 GDAL_DATA 和 PROJ_LIB 是否生效GDAL 处理投影转换时需要数据文件这些文件在osgeo\data\gdal和osgeo\data\proj下。如果环境变量没指对做坐标转换时会报“无法找到 proj.db”之类的错误。验证方法from osgeo import osr sr osr.SpatialReference() sr.ImportFromEPSG(4326) print(sr.ExportToWkt())ImportFromEPSG(4326)会去读 proj 数据。能打印出 WKT 字符串就说明数据路径没问题。如果报错就手动设置set GDAL_DATAC:\Python27\Lib\site-packages\osgeo\data\gdal set PROJ_LIBC:\Python27\Lib\site-packages\osgeo\data\proj这两个变量建议写进系统环境变量别每次开 cmd 都设一遍。5.3 把安装过程固化成可重复的脚本Win7 机器往往不止一台每次手动装容易漏步骤。我习惯把整个流程写成一个 bat 脚本echo off REM install_gdal.bat set PYTHON_DIRC:\Python27 set WHL_DIRD:\gdal_whl set OSGEO_DIR%PYTHON_DIR%\Lib\site-packages\osgeo %PYTHON_DIR%\python.exe -m pip install numpy1.16.6 %PYTHON_DIR%\python.exe -m pip install %WHL_DIR%\GDAL-2.4.4-cp27-cp27m-win_amd64.whl setx PATH %PATH%;%OSGEO_DIR% /M setx GDAL_DATA %OSGEO_DIR%\data\gdal /M setx PROJ_LIB %OSGEO_DIR%\data\proj /M echo done, please reopen cmd pausesetx是写系统环境变量的命令/M表示系统级而不是用户级需要管理员权限运行。脚本跑完必须重开 cmd 才生效。这个脚本我用了很多次唯一要注意的是%PATH%在 setx 里会被展开成当前值如果 PATH 已经很长可能触发长度限制。遇到这种情况就手动去系统属性里加别硬用脚本。最后说个我自己的习惯每次装完 GDAL我都会把 wheel 文件、验证脚本、bat 安装脚本一起打包放到一个固定目录命名带上日期和版本号。Win7 这种老环境过半年再回来维护时你根本记不住当时装的是哪个版本、PATH 怎么配的。留一份可复现的记录比事后翻聊天记录靠谱得多。希望帮到你。本文还有配套的精品资源点击获取