1. 为什么都2025年了我还要写一份ArcGIS 10.2.2的Python配置教程前两天在群里看到有人问ArcGIS 10.2.2自带的Python 2.7.5怎么装pip底下还有人回复用Python 3不好吗。说实在的这个版本确实老了点但架不住还有大量单位、科研项目、老库房里的数据管线在用这套软件。有很多机器承载着历史项目不能随便升级一旦动版本几个老脚本、自定义工具箱全得跟着改风险太大。所以折腾好自带的Python 2.7.5环境依然是某些场景下的刚需。这篇博文不聊要不要换平台只聊怎么把ArcGIS 10.2.2自带的Python 2.7.5环境收拾利索——从最让人头疼的pip安装到国内源配置再到gdal库的二进制安装和arcpy模块的正常调用。每一步我都自己踩过坑文中会把这些坑的位置、原因、绕行方案都讲清楚。只要你手里有ArcGIS 10.2.2安装包照着一步步操作半小时内就能把这套老环境调到能正常pip装包、能import arcpy、能跑gdal脚本的状态。适合三类人看第一类是GIS方向的在校生实验室或老师给的课程资料依赖10.2.2第二类是自然资源、测绘、规划相关单位的技术人员内网机器锁定版本不能动第三类是接手老项目的开发维护者需要在不破坏现有环境的前提下补齐Python工具链。至于那些可以自主选型的新项目我建议直接上ArcGIS Pro或Python 3没必要在这里受罪。说句实在话ArcGIS 10.2.2的Python 2.7.5环境本质上是一个锁了门的完整PythonESRI在安装时已经装好了numpy、matplotlib这些常用包但没有顺手装pip。这种半封闭状态导致很多人第一次想装第三方库时就卡住了。接下来每一步我都会配合实际操作说明尽量让你少走弯路。2. 动手前先摸清环境路径、位数、还有那个极易被忽视的Desktop10.2文件夹很多教程上来就让你跑命令结果跑到一半发现路径不对、装错了位数甚至根本不知道自己的Python被装到了哪里。ArcGIS的Python环境跟普通Python安装不太一样路径结构有它自己的脾气先花三分钟把基本盘摸清后面能省下一大堆事。2.1 找到真正的Python解释器ArcGIS 10.2.2安装时Python 2.7.5会被安装到ArcGIS安装目录下的Python27文件夹里典型路径是C:\Python27\ArcGIS10.2\注意不是C:\Python27\根目录也不是C:\ArcGIS\Python27\。这一点特别容易看错。ESRI把解释器放在C:\Python27\ArcGIS10.2\python.exe除此之外可能还有C:\Windows\py.exe之类的其他存在但ArcGIS实际调用的就是上面这个。验证方法很简单打开命令行切换到该目录执行C:\Python27\ArcGIS10.2\python.exe -c import sys; print(sys.version)如果输出了2.7.5 (default, May 15 2013, 22:44:16) [MSC v.1500 32 bit (Intel)]说明路径正确。注意看32 bit字样。2.2 32位还是64位装错就是白折腾ArcGIS 10.2.2的Desktop版本默认随附的是32位Python 2.7.5虽然你的操作系统大概率是64位Windows但解释器本身是32位的。这就带来一个连锁反应后续安装任何第三方库版本都必须对应32位win32的wheel包你要是装了64位的GDAL、PyQT或者其他编译包就会出现各种DLL load failed或者ImportError: No module named的玄学问题。这可能是整套配置里最核心的一个认知。很多人卡在gdal导入阶段很多天最后发现只是把64位的包装进了32位解释器。怎么确认当前位数在上一步的sys.version输出里已经写了32 bit也可以在Python里执行import struct print(struct.calcsize(P) * 8)输出32就是32位解释器64就是64位。2.3 检查环境变量与“默认真实解释器”的问题ArcGIS 10.2.2的安装程序通常不会把Python目录加到系统PATH里这就是为什么你在命令行直接敲python --version经常会提示不是内部或外部命令。这倒不是大问题后面配置pip时会解决但你自己得清楚得用绝对路径调用或者把目录手动加到PATH里。另外如果你机器上同时装有其他Python版本比如Python 3.9或者Anaconda命令行里的python指向的很可能不是ArcGIS这个装包时极易装错地方。为解决这个问题建议配置完成后单独把C:\Python27\ArcGIS10.2和C:\Python27\ArcGIS10.2\Scripts加入PATH并且排在系统PATH的前面保证执行的python和pip都指向ArcGIS的环境。注意修改PATH前先记录原值方便今后恢复。改完后新开的命令行窗口才会生效。概括一下这阶段的目标不是立刻装包而是彻底搞清楚你手里的解释器在哪、是什么位数、默认会不会跑错。这三件事不确认明白后面的pip、gdal、arcpy全都会出一些让人抓狂的疑难杂症。3. pip安装全流程用get-pip.py绕过最经典的“无pip”困境ArcGIS 10.2.2自带的Python 2.7.5安装目录下没有pip。如果你直接运行pip -V系统会无情地告诉你pip不是内部或外部命令。这在当年是个老生常谈的问题解决办法也比较统一用get-pip.py引导安装。3.1 下载与执行get-pip.py需要先下载适合Python 2.7的get-pip.py脚本因为Python 2.7已经停止维护新版get-pip.py往往只支持Python 3所以找历史版本或者从pip官方仓库的2.7分支拿比较稳妥。下载完成后把脚本放到一个方便的位置比如C:\Python27\get-pip.py然后执行C:\Python27\ArcGIS10.2\python.exe C:\Python27\get-pip.py正常情况下脚本会自动安装pip、setuptools和wheel。安装完成后检查一下是否成功C:\Python27\ArcGIS10.2\python.exe -m pip --version如果输出pip 9.0.1 from C:\Python27\ArcGIS10.2\lib\site-packages (python 2.7)说明装好了。为什么特别提pip 9.0.1因为它基本是Python 2.7能用的最后一个稳定大版本后面的pip 18、19虽然也支持2.7但有些依赖会出问题。用get-pip.py在2.7下安装时拿到的一般就是9.x版本这也是符合实际预期的一个结果。3.2 Scripts目录与命令找不到的问题pip安装后会生成C:\Python27\ArcGIS10.2\Scripts\pip.exe。但命令行直接敲pip时可能会提示找不到命令原因很简单——Scripts目录不在PATH里。解决办法有三个把C:\Python27\ArcGIS10.2\Scripts加入系统PATH每次使用C:\Python27\ArcGIS10.2\python.exe -m pip替代直接敲pip用C:\Python27\ArcGIS10.2\Scripts\pip.exe绝对路径调用。我个人的建议是把Scripts目录加进PATH因为后面很多命令行工具比如gdal的几个脚本工具也会安装到这个目录不用绝对路径的话太痛苦。但如果你极其排斥改PATH那么python -m pip这种写法是第二优选。3.3 配置国内镜像源源不好等于装什么都慢如果你是裸网络环境用官方源装一个小包装半天都是常事甚至直接超时失败。配置国内源是最实际的一步优化。Python 2.7里的pip不支持较新的pip config命令部分功能但可以通过修改配置文件实现。Windows下路径为C:\Users\你的用户名\pip\pip.ini如果pip文件夹和pip.ini文件都不存在就手动创建。内容如下[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host pypi.tuna.tsinghua.edu.cn第一行指定了包下载源第二行是为了让pip信任该源的HTTPS证书避免在不受信任的情况下被拒绝。如果清华源速度不理想可以换成阿里云源index-url https://mirrors.aliyun.com/pypi/simple/ trusted-host mirrors.aliyun.com我个人习惯是清华源优先必要时换阿里。配置好后用pip install numpy这类命令实测一下下载速度应该能明显感觉到差别。3.4 验证pip可用性的三个命令配置完成后建议依次执行以下三个命令确认pip真的可用C:\Python27\ArcGIS10.2\python.exe -m pip --version C:\Python27\ArcGIS10.2\python.exe -m pip list C:\Python27\ArcGIS10.2\python.exe -m pip install setuptools --upgradepip list能看到目前已安装的包列表ArcGIS预装的numpy、matplotlib、pyparsing等会出现在里面。把setuptools升级一下是为了避免老版本setuptools在后续安装某些依赖包时出现兼容性错误。到这里pip已经不再是拦路虎。类似的安装逻辑其实适用于ArcGIS 10.0、10.1、10.4等老版本只要底层还是Python 2.7这套引导流程就大体相同。具体差别主要体现在路径和版本号上掌握原理后就能一通百通。4. 为Python 2.7.5安装gdal版本匹配是唯一王道很多人装gdal都是从源码编译开始结果被复杂的依赖关系折磨到怀疑人生。别把自己搞得那么累——在Windows上给老Python装gdal直接用编译好的wheel包除非特殊场景否则别碰源码编译。4.1 从哪里找适合的gdal wheelPython 2.7能用的gdal wheel最常用的来源是Christoph Gohlke维护的非官方二进制包页面。这个网站像一座宝库上面几乎各种Python版本、各种位数、各种库的Windows安装包尤其适合老版本Python。虽然网站界面很朴素但实用价值极高。你需要找的文件名大致长这样GDAL-2.2.4-cp27-cp27m-win32.whl拆开解释一下cp27表示CPython 2.7cp27m表示启用了Unicode UCS4的构建Python 2.7默认就是win32表示32位Windows版本不是win_amd64。下载时务必看清这三个标记三者任一不匹配装完都会出错。还记得前面解释器是32位这件事吗这就是决定因素。如果你下载了win_amd64的包pip会直接报not a supported wheel on this platform或者强迫你使用--force-reinstall但装完后import gdal时会报DLL错误。4.2 安装gdal wheel包拿到whl文件后通过pip安装即可C:\Python27\ArcGIS10.2\python.exe -m pip install C:\Downloads\GDAL-2.2.4-cp27-cp27m-win32.whl不推荐用pip install gdal直接从源站拉取因为Python 2.7下很可能找不到匹配的预编译包然后它会尝试下载源码并编译没有完整VC 9.0编译环境的话基本是必败结局。安装完成后gdal会自带一个隐藏依赖——numpy如果你系统中已经存在ArcGIS自带的numpy它会复用之前的版本一般能满足需求。实测中ArcGIS 10.2.2自带的numpy版本是1.7.1gdal 2.2.4要求numpy1.5.0完全满足条件。4.3 验证导入并解决“DLL load failed”问题安装只是第一步真正的考验是导入C:\Python27\ArcGIS10.2\python.exe -c from osgeo import gdal; print(gdal.__version__)如果输出2.2.4恭喜你成功了。如果报ImportError: DLL load failed: The specified module could not be found大概率原因有三装了64位gdal但解释器是32位缺少VC 9.0运行库gdal的dll依赖的某些系统文件缺失。第一个问题的解决办法是卸载重装32位版本第二个问题的解决办法是安装Microsoft Visual C 2008 Redistributable Packagex86第三个问题一般会在安装完VC运行库后自动解决因为gdal的dll依赖的通常是系统通用运行库。还有一个容易忽视的问题ArcGIS自带的Python 2.7.5路径下没有osgeo目录但gdal装好后会自动生成。如果你在另一套Python环境里也装了gdal并且两个环境的site-packages路径存在混用也会出现版本莫名其妙的情况。为了避免环境串味建议用前面提到的绝对路径来执行Python命令确保始终操作的是正确的那一套环境。4.4 顺便把gdal的Python脚本也加入路径gdal wheel包内会附带一些可执行的Python脚本比如gdalinfo.py、ogr2ogr.py。这些脚本会被安装到C:\Python27\ArcGIS10.2\Scripts\目录下跟pip.exe在一起。实际使用中你完全可以在Python代码里调用gdal的API而不必依赖这些命令行脚本但如果你有命令行处理栅格、矢量数据的习惯把它们加入PATH也挺好。到这里gdal部分就算全通了。一个常见问题提醒一下gdal版本新旧会影响API行为2.2.4还算是一个比较经典的版本跟ArcGIS 10.2.2搭配时似乎在重投影、格式转换这些常规操作上都没有发现明显兼容性问题。提示不要在ArcGIS自带的Python里试图安装gdal 3.x系列。那类版本主要面向Python 3环境部分数据结构已经变了强行装到2.7上虽然不会让你电脑爆掉但使用新版API时会有很多接口坑没必要给自己找麻烦。5. arcpy调用让脚本在ArcGIS之外也能平稳运行arcpy和gdal是很多GIS脚本里的两套主力工具。gdal是通用地理数据读写库arcpy则是ArcGIS的专有Python接口。很多人配置完gdal以为大功告成结果在命令行里尝试import arcpy时又碰壁了。下面先把arcpy的机制讲清楚再给出具体调用方法。5.1 arcpy到底是啥为什么不能随便importarcpy是ESRI提供的Python站点包它不是一个独立的第三方库而是深度绑定ArcGIS Desktop安装环境的。它依赖很多ArcGIS的底层COM组件、许可管理器以及arcgis安装目录下的一系列dll。你在Python命令行里直接import arcpyPython解释器需要在site-packages里找到arcpy文件夹同时还要能在系统里定位到ArcGIS的DLL和License相关服务。ArcGIS 10.2.2安装时已经自动把arcpy站点包放进了C:\Python27\ArcGIS10.2\Lib\site-packages。理论上用正确的解释器去import是能直接成功的。但很多人实际运行时报ImportError: No module named arcpy原因一般有两个一是你用了错误的Python解释器比如系统的Python 3或另一个Python 2.7二是当前命令行的工作目录或PYTHONPATH变量出了问题。5.2 命令行里验证arcpy打开命令行执行C:\Python27\ArcGIS10.2\python.exe -c import arcpy; print(arcpy.GetInstallInfo()[Version])如果输出10.2.2说明arcpy在命令行环境下已经可用了。如果提示RuntimeError: Not initialized或者类似错误大概率是ArcGIS许可服务没启动或者你的机器上根本没有有效的ArcGIS许可。这时候需要打开ArcMap或ArcCatalog一次让软件初始化许可后再试。有一点值得说明arcpy在命令行里的行为跟从ArcMap的Python窗口里运行并不完全一样。在ArcMap的Python窗口里ArcGIS会自动注入一些环境变量和许可相关信息所以经常出现窗口里能跑命令行跑不了的怪象。知道了这个差异去排查时就有方向了。5.3 在脚本里合理混用arcpy和gdal有些场景下你可能希望在gdal和arcpy之间快速切换。举个典型例子用gdal读一个大尺寸GeoTIFF的元数据再用arcpy做要素类层面的分析。这种混用在老环境里完全可行只要注意数据格式之间的转换就行。# -*- coding: utf-8 -*- from osgeo import gdal import arcpy # 用gdal读取栅格尺寸 ds gdal.Open(rD:\data\dem.tif) width ds.RasterXSize height ds.RasterYSize print(u栅格尺寸: {0} x {1}.format(width, height)) # 用arcpy创建要素类 arcpy.env.workspace rD:\data fc sample.shp if not arcpy.Exists(fc): arcpy.CreateFeatureclass_management(rD:\data, sample.shp, POLYGON) print(arcpy create done)这只是一个很小的示例但你可以从中看出两者配合使用的基本姿势。使用过程中务必要注意数据路径分隔符的写法。Python 2.7在Windows中文路径下经常踩编码坑所以脚本文件头最好加上# -*- coding: utf-8 -*-涉及中文路径时建议在字符串前加u前缀必要时用decode(gbk)或encode(utf-8)做转换。因为ArcGIS 10.2.2那个年代的Windows中文环境文件路径的编码完全是GBK体系的不处理的话写字楼里没少见SyntaxError或者IOError: [Errno 22] invalid mode这类质疑。其实根源就是编码问题。5.4 处理arcpy环境变量与输出路径用arcpy时arcpy.env.workspace是全局变量设置后大多数工具函数都默认在这个工作空间里操作。而gdal则更倾向于用路径字符串直接传参数。混用时建议每个函数都显式传递完整路径而不是依赖环境变量避免两边状态不一致导致找不到文件。另外arcpy对输出路径存在已存在判断逻辑如果目标文件已经存在部分工具会报错所以写脚本时先arcpy.Exists()判断一下是好习惯。这点跟gdal的处理方式很不一样gdal的CreateCopy会默许覆盖而arcpy的很多工具如果存在同名的要素类或数据集会直接拒绝执行。6. 实战踩坑与排查链路pip报错、DLL缺失、版本混乱逐个拆解老环境配置的最大问题有两个一是可用文档少且分散二是很多报错信息看起来像英文天书实际上原因却很简单。把我前后折腾的坑整理成排查链路一次性说清楚。6.1 pip调用报错的三种典型场景场景A输入pip -V提示不是内部或外部命令。原因是Scripts目录未加入PATH或者安装后新开的命令行窗口没生效。解决确认C:\Python27\ArcGIS10.2\Scripts在PATH中关掉命令行重新开。场景B输入pip提示Fatal error in launcher: Unable to create process using...。这个问题在Python 2.7的pip里很常见多数时候是pip的shebang行或者环境变量指向了另一个版本的Python。解决用C:\Python27\ArcGIS10.2\python.exe -m pip ...代替直接调用pip.exe或者重新执行一次get-pip.py修复pip。场景C安装包时提示Could not find a version that satisfies the requirement。这是Python 2.7的老生常谈由于大量新库已放弃Python 2.7版本支持列表里匹配不到新版并不意味着库不存在。解决指定可用版本号比如python -m pip install pandas0.24.2 python -m pip install requests2.22.0如果不是非要最新版尽量选择2.7时代最后一个大版本稳定性会更有保障。6.2 gdal导入报错的完整排查链路一步步走别跳确认解释器是32位import struct print(struct.calcsize(P) * 8)输出32还是继续检查输出64说明你用错了环境。确认已安装的gdal包架构python -m pip list看GDAL版本号是否有cp27或win32的标记。检查C:\Python27\ArcGIS10.2\Lib\site-packages\osgeo\目录下有没有gdal的pyd文件。正常情况会有一堆gdal*.pyd。如果目录为空或文件大小异常卸载重装。安装了Microsoft Visual C 2008 Redistributablex86这一步很关键但不常被提及。再执行导入测试。如果还报错使用Dependency Walker查看gdal203.dll的依赖项是否完整。不过这个工具较老也可以用Dependencies这个开源替代品。不过对于大部分场景走到步骤4基本就能解决了。6.3 版本不匹配造成的“隐形错误”还有一种更隐蔽的情况机器上装有另一个Python 2.7比如Anaconda 2或ESRI还有其他插件装的Python并且它的Scripts目录也在PATH里。你敲pip install gdal时可能装到了那个环境的site-packages然后你用ArcGIS的python.exe去import自然是找不到的。排查方法很简单where python where pip看看实际找到的第一个python和pip指向哪里。如果指向的不是C:\Python27\ArcGIS10.2\那就说明PATH顺序出问题了。把ArcGIS Python路径调整到最前即可。6.4 Python 2.7时代特有的编码坑在Python 2.7里字符串的默认编码是ASCII遇到中文路径或中文字符串时极易抛UnicodeDecodeError或者UnicodeEncodeError。这个问题在ArcGIS环境里尤其常见因为地理数据路径含中文的概率很高。建议在所有脚本开头统一加上# -*- coding: utf-8 -*- import sys reload(sys) sys.setdefaultencoding(utf-8)这算是Python 2.7时代的土办法但确实有效。需要注意的是Python 2.7的reload(sys)和setdefaultencoding(utf-8)仅仅是把解释器默认编码改了并不能让每个第三方库都自动处理编码问题。更稳妥的办法是路径字符串用u...前缀写成Unicode文件读写时显式指定编码比如open(fp, rb)或者codecs.open(fp, r, utf-8)。7. 进阶配置让老环境用得稍微舒服一点环境配置好了只是起点。后续日常使用中还有几个值得做的优化项我根据自己的经验逐个说。7.1 把Scripts加入PATH让命令行交互更顺手前面提过这一步很基础但也容易忘。操作路径是右键此电脑→属性→高级系统设置→环境变量→编辑Path→新建两条C:\Python27\ArcGIS10.2 C:\Python27\ArcGIS10.2\Scripts保存后重开命令行直接敲python和pip应该都能识别。7.2 正确管理多个Python环境的PYTHONPATH如果你机器上同时有Python 3和ArcGIS自带的Python 2.7建议不要手动设置全局PYTHONPATH因为那会导致两个环境互相污染。正确的做法是需要哪个环境就在对应环境的site-packages里装包调用时用python -m pip并且不要设置可能会串环境的PYTHONPATH项。7.3 做一个环境一键检测脚本为了快速判断环境是否正常可以把下面这段脚本存成check_env.py需要时跑一下# -*- coding: utf-8 -*- import sys print(Python:, sys.version) try: import arcpy print(arcpy OK:, arcpy.GetInstallInfo()[Version]) except Exception as e: print(arcpy FAIL:, e) try: from osgeo import gdal print(gdal OK:, gdal.__version__) except Exception as e: print(gdal FAIL:, e) try: import pip print(pip OK:, pip.__version__) except Exception as e: print(pip FAIL:, e)执行C:\Python27\ArcGIS10.2\python.exe check_env.py看到三项都OK说明环境基本健康。如果哪天脚本跑不起来了优先用这个脚本定位问题的范围。7.4 备份site-packages快速恢复环境ArcGIS的Python环境虽然不能像Anaconda那样方便地导出环境快照但可以把整个C:\Python27\ArcGIS10.2\Lib\site-packages目录压缩备份一份。遇到环境被搞坏、重装系统等情况解压回去就能恢复大半。虽然听起来有点土但确实是我用过最靠谱的恢复方案。在某些严格的单位内网环境里没法随便下载包备份包文件几乎是唯一出路。具体操作把site-packages压缩包放在网络盘或移动硬盘上同时把C:\Python27\ArcGIS10.2\Scripts里的exe和dll也备份一份因为有些包比如gdal的脚本工具会安装到那里。7.5 VSCode里指向老Python环境现在很多人写脚本用VSCode想在里面选择ArcGIS的Python 2.7.5解释器只需在VSCode里通过命令面板选Python: Select Interpreter然后在路径列表里找到C:\Python27\ArcGIS10.2\python.exe或者直接输入该路径。选好之后VSCode右下角会显示当前解释器路径。同时建议安装Python插件后把python.pythonPath显式设为ArcGIS的解释器路径。有一点需要注意VSCode的Python插件最新版本对Python 2.7的支持已经非常有限有时会出现调试器不兼容、代码提示失效的问题。如果想省心可以直接用更轻量的编辑器配命令行执行或者用旧版本的VSCode扩展。当然单纯用来写代码不做调试的话问题不大。8. 一些零碎但重要的经验备忘最后这部分写一些不一定成体系但实际用下来确实能减少麻烦的零碎经验。第一能不重装系统就尽量不要重装。重装后ArcGIS的许可服务经常出问题而Python环境也可能因为注册表项丢失而导致arcpy无法使用。如果你必须重装事先把ArcGIS的安装包、许可服务程序、Python site-packages备份都准备好会省下至少半天的恢复时间。第二安装任何第三方库前先看一下它是否依赖C运行库。比如pyshp、shapely、Pillow这些库都可能依赖特定的VC版本而32位Python 2.7通常对应的是VC 9.0。本身ArcGIS自带的Python是用VS2008编译的所以装新包时最好匹配同一个编译链的版本不然DLL问题会一波接一波。第三如果你打算用arcpy做大数据量处理先测一下内存和临时目录空间。这个问题跟Python环境本身无关但很多老机器跑着跑着就报错根因其实是临时目录被占满。ArcGIS的栅格处理工具在工作时会生成大量临时文件默认临时目录在C:\Users\你的用户名\AppData\Local\Temp如果系统盘空间不足处理就会中途挂掉。可以在脚本里设置arcpy.env.scratchWorkspace指向另一块空间充足的磁盘。第四在国内网络环境下pip源配置要是还没做赶紧做。不配源的话光装一个几十MB的gdal wheel可能就要反复重试几个小时配好源之后基本是秒级下载。这条经验在今天同样适用跟是不是老环境无关。要说这套环境还能用多久我个人觉得它作为一个历史遗留系统的配套工具还会存在相当长一段时间。数据不会因为软件版本老就不见了业务流程也不会因为Python 2.7停止维护就立刻切换。所以把环境盘明白了该写脚本写脚本该出图出图别被工具版本拖累就行。另外如果你实在无法忍受这套老环境的各种限制但又必须兼容旧数据可以考虑用Docker容器化一个独立的Python 2.7 GDAL环境和ArcGIS Desktop本体分开跑。容器里做数据处理ArcGIS桌面端负责可视化和编辑两者通过共享文件目录交换数据这样能稍微隔离一下老环境的脆弱性。不过这属于另一种玩法了工作量也不小属于备选方案。说到底工具只是手段把活干利索才是目的。希望这份配置攻略能帮你少走点弯路。