ArcGIS Pro 3.4安装配置与避坑指南:许可、Python环境全解析
简介ArcGIS Pro 3.4学习版安装教程配套的可运行源码包面向GIS初学者及需要快速搭建桌面GIS环境的用户。教程围绕解压文件、安装Microsoft Windows Desktop Runtime、主程序安装与中文语言包配置展开以图文结合方式逐步骤说明并梳理了新版本在从所选内容生成定义查询、3D切片共享、组合图表、高光谱影像及AI集成等方向的改进便于读者快速掌握安装流程与版本特性。包内共3个文件以网页教程文档为主辅以可运行工程入口与版本配置信息整体压缩包仅5KB结构精简适合对照阅读并直接查看源码组织方式。已有297人浏览学习对于准备上手ArcGIS Pro或希望基于现有工程开展二次开发实践的用户是一份低门槛、可落地的入门参考资料。1. ArcGIS Pro 3.4 安装包到手先别急着双击三个实际问题要先想清楚ArcGIS Pro 3.4 整个安装过程其实不算复杂但真正折腾人的永远是装完之后那几步——授权怎么生效、Python 环境为什么打不开、地图文档里的字体为什么全都变形。这套带可运行源码的 ArcGIS Pro 3.4 安装包解决的不只是“把软件装上”而是把许可配置、Python 运行环境、汉化文件、常用工具箱打包在一起装完就能直接进入工作状态。适合三类人来用需要离线环境做 GIS 开发的工程师、想在虚拟机里做 ArcGIS Pro 环境复现的测试人员、以及受够了每次重装系统都要重新配一遍 Python 环境的技术支持。我用这套资源重装过四次踩过授权失效、conda 源被墙、破解文件被杀软隔离这些坑后面每一章都会把对应的现象和处置讲清楚。你拿到安装包后先别急着双击先花三分钟看完这篇能省下至少一下午折腾时间。2. 安装前的环境准备系统版本、运行库与安装包校验2.1 为什么 3.4 对系统版本和 .NET 运行库这么敏感ArcGIS Pro 3.4 的安装器底层依赖 Windows Installer 5.0 和 .NET Framework 4.8这两个组件缺一个都会造成安装中途回滚。最常见的问题出现在 Windows 10 LTSC 2019 或者精简版系统上——这类系统默认不带 .NET 4.8而 Pro 的安装向导在检测到缺少组件时并不会主动帮你装只会直接报错退出去。安装前先确认两件事。第一系统必须是 64 位 Windows 10 或 Windows 11Pro 3.4 官方已经放弃了对 Windows 7 的支持。这里有个容易忽略的点如果你是在虚拟机里安装虚拟机系统也要按 64 位配置并且内存建议不小于 8GB否则安装过程中解压临时文件很容易触发内存不足导致回滚。第二提前安装 .NET 4.8 和 Visual C 2015-2022 运行库。.NET 4.8 的离线安装包可以直接在微软官网下载VC 运行库建议装 x64 版本。我一般会在装 Pro 前先把这两个组件用命令行静默装掉避免安装向导中途跳出来要求重启。# 安装 .NET 4.8ndp48-x86-x64-allos-enu.exe 为离线安装包 ndp48-x86-x64-allos-enu.exe /qn /norestart # 安装 VC 运行库/install 表示静默安装/norestart 防止安装后重启 vc_redist.x64.exe /install /quiet /norestart参数说明/qn是 .NET 安装包的无界面模式适合在脚本里批量执行/norestart控制安装完成后不自动重启系统提示需要重启时再手动重启。vc_redist.x64.exe的/install /quiet是静默安装的固定写法执行完不会有任何弹窗。装完后可以在命令行里执行reg query HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full /v Release查看 .NET 版本号如果输出的 Release 值大于或等于 528040说明 .NET 4.8 已生效。2.2 安装包完整性校验与目录规划这套带源码的安装包一般会同时包含主安装程序、授权工具目录、Python 环境包和汉化文件几个部分。拿到手先不要直接解压建议先对主安装包做一次哈希校验确认文件没有被杀毒软件拦掉或者下载过程中损坏。import hashlib # 计算安装包的 SHA256 值和发布方提供的哈希值做对比 file_path rD:\ArcGISPro_34\ArcGISPro_34_192XXXX.exe sha256_hash hashlib.sha256() with open(file_path, rb) as f: for chunk in iter(lambda: f.read(65536), b): sha256_hash.update(chunk) print(sha256_hash.hexdigest())这段脚本是逐块读取文件的每块 64KB不会因为文件过大占满内存。校验的意义在于如果哈希值和发布方给的不一致八成是文件下载不完整或者在某些解压软件里被二次修改过这时候直接装大概率会报“安装源损坏”。目录规划上我建议单独建一个D:\ArcGIS_Install作为安装包解压目录不要把安装包解压到桌面或者用户目录。原因是 ArcGIS Pro 安装过程中会在%TEMP%目录缓存大量文件如果临时目录本身空间不足安装会被静默中断。确认一下解压目录所在分区至少有 15GB 空闲空间Pro 本体加上 Python 环境装完大概要占 8GB 左右剩余空间用来存临时缓存。另外安装目录不建议选默认的C:\Program Files\ArcGIS\Pro。原因不是路径不能带空格而是很多二次开发环境在识别带空格的路径时会出现引号转义问题。我一般会自定义到D:\ArcGIS\Pro这个习惯能省掉很多后面写脚本时的转义烦恼。注意如果安装包里有所谓的“绿化工具”或“注册表注入脚本”先看一眼杀毒软件的隔离记录再去关防护。很多这类工具会被 Windows Defender 误报但直接关掉防护又可能让真正的病毒趁虚而入。最稳妥的做法是把整个解压目录加入 Defender 的排除列表。3. 安装流程与参数设置从向导安装到静默安装3.1 向导安装的关键参数运行主安装程序后安装向导会连续弹出几个设置页每一页选择参数都会影响最终环境。先说必须改的两个选项。第一个是安装位置前面已经提到自定义到D:\ArcGIS\Pro。第二个是 Python 环境的安装路径这个很容易被忽略——ArcGIS Pro 3.4 自带一个 Python 3.9 的运行环境包含 conda 和 arcpy。默认情况下 Python 环境会装在C:\Program Files\ArcGIS\Pro\bin\PythonEnv如果你改过 Pro 的主目录Python 环境会自动跟着走。但有一种情况需要手动处理如果机器上已经装了 Anaconda 或者 MinicondaPro 默认会尝试复用已有的 conda 基础环境这会导致 arcpy 的依赖冲突。我的做法是安装时选择“仅使用 ArcGIS 自带的 Python 环境”不让它去扫描机器上已有的 conda。这样虽然会多占约 2GB 磁盘空间但能保证 arcpy 和相关依赖版本是配套的。安装向导里对应的选项是“安装 ArcGIS Python 环境推荐”默认选中保持勾选即可。安装类型上有“完整安装”和“自定义安装”两种。完整安装包含所有 ArcGIS Pro 的扩展模块包括 Spatial Analyst、3D Analyst、Network Analyst 这些默认模块。自定义安装则可以单独勾选要安装的模块。对于做通用开发的人来说完整安装就行装完不用再担心缺某个工具箱。3.2 Python 环境与 Conda 的联动ArcGIS Pro 3.4 自带的 Python 环境严格来说是一个 conda 环境安装完成后可以在C:\Program Files\ArcGIS\Pro\bin\PythonEnv\python.exe找到解释器。安装完第一件事是打开命令行执行以下命令确认环境可用# 进入 ArcGIS Pro 自带的 Python 环境 cd /d D:\ArcGIS\Pro\bin\PythonEnv # 检查 python 版本 python --version # 确认 arcpy 可以被导入 python -c import arcpy; print(arcpy.GetInstallInfo()[Version])正常情况下python --version输出 3.9.xarcpy.GetInstallInfo()[Version]输出 3.4.0。如果 arcpy 导入时报ModuleNotFoundError说明安装时 Python 环境没有装完整。用 Pro 自带的 conda 创建独立环境也很常见。如果你不想动默认的arcgispro-py3环境可以克隆一份出来做定制# 克隆默认环境新环境名为 dev_env conda create --clone arcgispro-py3 --name dev_env # 激活新环境 conda activate dev_env # 在新环境里安装第三方库 conda install numpy pandas geopandas -c conda-forge --yes参数说明--clone会完整复制一份环境目录所以磁盘上要有足够空间。-c conda-forge是指定从 conda-forge 频道拉包这个频道里的包更新及时但国内下载速度不稳定。为了提速我一般会在装完后配置国内镜像源。# 添加国内镜像源提升下载速度 conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ conda config --set show_channel_urls yes注意镜像源的配置要写在克隆环境之前否则克隆时会直接走默认源速度会非常慢。如果已经克隆完了也没关系配置好源之后新装包时会走镜像只是克隆本身的历史包袱还在。3.3 静默安装的命令行参数对于需要批量部署的场景手动点安装向导效率太低。ArcGIS Pro 3.4 的主安装程序支持静默安装模式可以在命令行里指定安装路径、Python 环境位置以及授权信息。以下是常用的静默安装参数组合# 静默安装完整版自定义安装路径为 D:\ArcGIS\Pro start /wait D:\ArcGIS_Install\ArcGISPro_34_192XXXX.exe /qb INSTALLDIRD:\ArcGIS\Pro /norestart # 同时指定 Python 环境路径 start /wait D:\ArcGIS_Install\ArcGISPro_34_192XXXX.exe /qb INSTALLDIRD:\ArcGIS\Pro PYTHONENVD:\ArcGIS\Pro\bin\PythonEnv /norestart参数说明/qb是 InstallShield 的“基础 UI”模式会显示一个带进度条的窗口但不需要交互。INSTALLDIR指定主程序安装路径PYTHONENV指定 Python 环境路径这两个目录必须不能相同否则安装器会报路径冲突。/norestart控制安装完成后不自动重启系统适合在自动化脚本中使用。静默安装完成后可以通过查看安装日志确认是否成功# 安装日志默认位于临时目录 dir %TEMP%\ArcGISPro*.log # 查找安装结果关键标识 findstr /i success installed %TEMP%\ArcGISPro*.log如果日志中出现Error 1603或Installation failed就要回到上一章的环境检查项逐条排查。4. 授权与免登录License 配置的三种方式和实操边界4.1 三种授权方式怎么选ArcGIS Pro 3.4 的授权方式和老 ArcMap 完全不同。ArcMap 是单机 License Manager 授权Pro 则默认走 ArcGIS Online 账户登录的 Named User 模式。在离线环境或没有组织账号的情况下需要切换到单机授权。三种授权方式对比如下授权方式适用场景离线可用需要 License ManagerNamed User有组织账号联网办公不支持不需要Single Use单机离线开发支持需要Concurrent Use多人共享浮动许可支持需要这套可运行源码包里通常自带的是 Single Use 模式的许可工具也就是用授权码在本地生成一份许可文件让 Pro 以离线模式运行。重点确认一下包里的授权工具是面向 3.4 版本的因为 Esri 从 ArcGIS Pro 3.0 后改了许可文件加密方式用旧版本工具生成的许可文件在 3.4 上会直接识别失败。4.2 License Manager 安装与许可导入如果你拿到的是浮动许可码需要先装 ArcGIS License Manager 2024.1对应 Pro 3.4 的版本再导入许可。安装 License Manager 本身没什么难度但有一个坑License Manager 和 Pro 不能装在同一个目录否则两个程序的配置文件会互相覆盖。License Manager 装好后打开 Administrator 界面选择“许可”选项卡粘贴你拿到的授权码点击“授权”生成许可文件。生成后确认状态显示“可用”再继续。之后在 ArcGIS Pro 里切换授权方式打开软件进入“授权选项”对话框选择“使用单机版许可”浏览到 License Manager 生成的许可文件路径。这里有个关键细节——许可文件的扩展名是.lic但 Pro 的浏览对话框默认只显示.prv文件。需要在文件类型下拉框里切到“所有文件”否则找不到刚生成的许可。4.3 免登录设置的使用边界安装包里如果带“免登录”工具它实际做的是让 Pro 跳过启动时的 ArcGIS Online 账户验证。这类工具的常规做法是替换AfCore.dll或修改~\AppData\Local\ESRI\ArcGISPro\Settings\Environment.cfg里的授权配置。环境和杀软是关键变量我会在这种情况优先选择干净环境测试。免登录设置有几个使用边界要说清楚。第一免登录只对 Pro 主程序生效不解决扩展模块的授权问题Spatial Analyst 这类扩展模块依然需要单独的许可。第二软件更新时如果自动下载了补丁免登录配置可能被重置需要重新设置。第三组织环境下使用免登录设置可能违反授权协议如果公司有正版授权不建议为了省事去改授权文件。注意如果你发现免登录工具替换了AfCore.dll记得在杀软里把 ArcGIS 安装目录加入排除列表。Windows Defender 偶尔会把这个 dll 识别为风险文件并隔离表现为 Pro 启动时黑匣子一样闪退没有任何错误提示。5. 安装避坑清单五个翻车现场与排查方法5.1 安装到一半报错 1603现象进度条走到大概 70% 的位置弹出Error 1603: 安装期间发生致命错误然后整个安装回滚桌面上留下一个装着半截文件的 ArcGIS 目录。原因1603 是 Windows Installer 的通用错误绝大多数情况下是被安装目录的权限卡住了。ArcGIS Pro 的安装服务需要在目标目录创建ArcGIS子目录如果目录已有同名文件夹且权限归属不是当前用户就会触发回滚。杀毒软件实时监控在安装过程中频繁锁文件也是常见诱因。解决先确认当前用户对安装目录有完全控制权限右键D:\根目录在安全选项卡里给 Users 组勾上完全控制。然后把 D 盘安装目录的排除项加进杀毒软件。最后清理掉半成品目录重新执行安装命令。# 清理半成品安装目录 rmdir /s /q D:\ArcGIS # 清理 Windows Installer 缓存中的残留项 msiexec /x {GUID} /qnmsiexec /x后面需要跟具体产品的 GUID不知道 GUID 的话可以用reg query HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall查找 ArcGIS 相关条目。5.2 打开就弹“无法创建进程”没有任何错误码现象安装过程一切顺利但双击桌面快捷方式后进程在任务管理器里闪一下就消失或者弹一个“无法创建进程”的对话框。原因这个问题九成出现在免登录工具替换 dll 之后。如果杀软隔离了被替换的AfCore.dllPro 启动时核心组件加载失败就会闪退。还有一种情况是Environment.cfg里写着无效的授权指向路径Pro 去读许可时找不到文件就直接退出。解决把 ArcGIS 安装目录加入杀软排除列表从隔离区恢复AfCore.dll。然后打开%LocalAppData%\ESRI\ArcGISPro\Settings\Environment.cfg检查里面的ESRI_LICENSE_HOST等授权字段是否指向正确的主机名或文件路径写错的改掉后保存再启动。5.3 arcpy 导入失败Python 环境没装上现象Pro 主程序能正常打开但写 Python 脚本时import arcpy直接红字报错ModuleNotFoundError。原因大概率是安装时选择了“不安装 Python 环境”或者静默安装时漏掉了PYTHONENV参数。Pro 主程序和 Python 环境是两个独立的安装单元主程序装成功不代表 Python 环境也跟着装好。解决不需要重装整个 Pro运行安装包在修改模式下勾选 Python 环境组件静默模式下补装一组参数# 重新添加 Python 环境修改安装模式 start /wait D:\ArcGIS_Install\ArcGISPro_34_192XXXX.exe /qb ADDLOCALPythonEnv INSTALLDIRD:\ArcGIS\Pro参数说明ADDLOCALPythonEnv是 InstallShield 的组件级控制参数表示只补装 Python 环境这一个组件不影响 Pro 主程序现有配置。5.4 授权后仍然显示未登录现象授权工具显示许可导入成功但打开 Pro 后右上角还是提示需要登录账户无法进入主界面。原因Pro 3.4 的授权状态读取顺序是从注册表到本地许可文件。常见的原因是启动时 Pro 优先连接了 ArcGIS Online 服务检测到网络后自动切换回 Named User 模式忽略了本地许可。另外如果系统时间不对许可时间戳验证失败也会出现这个情况。解决先断网启动一次确认离线情况下可以正常进入主界面。进入后打开“关于”对话框确认“许可类型”一栏显示“Single Use”。然后在选项里把“自动检测许可类型”关掉手动固定为单机版许可。5.5 升级后旧插件全部失效现象原本在 3.3 或 3.2 上能跑的 Add-In 插件装完 3.4 后全部变成灰色不可点击。原因Pro 的插件机制在 3.4 里没有做大改失效的根本原因是插件是 32 位编译的或者引用旧的 SDK 版本。Pro 3.4 对插件的最低 API 版本有要求低于该版本的插件会被静默禁用。解决在项目文件里把 SDK 版本引到最新重新编译发布。这个工作必须在装完 3.4 之后做因为旧版本 SDK 在 3.4 环境里也可能加载不了新 API 的头文件。如果只是自己用可以在 config 文件里开启“加载不受信任的插件”选项但正式部署不推荐这样。6. 装完怎么验证命令行检查、布局经纬网与拓扑清洗6.1 用一行 Python 验证核心模块装完先别急着打开界面我习惯先用命令行快速验证核心模块能不能跑。这一行命令能同时确认三件事Python 解释器是否正常、arcpy 是否能导入、授权是否生效。D:\ArcGIS\Pro\bin\PythonEnv\python.exe -c import arcpy; print(arcpy.GetInstallInfo()[Version]); print(arcpy.ProductName())如果输出3.4.0和ArcGIS Pro说明环境基本没问题。如果要进一步确认空间分析模块的授权可以执行D:\ArcGIS\Pro\bin\PythonEnv\python.exe -c import arcpy; print(arcpy.CheckOutExtension(Spatial))输出Spatial表示扩展许可已正常借用NotLicensed则是授权缺失。6.2 布局视图插入经纬网很多用户装完 Pro第一件事是出图加经纬网。Pro 3.4 和 ArcMap 完全不一样ArcMap 里的经纬网工具在 Pro 里被挪到了布局视图的“格网”功能里。操作为先切换到布局视图选中地图框在“格网和经纬网”里选择“经纬网”样式。默认样式只有一个外框加经纬线不够出图标准。建议在样式对话框里把“自定义格式”打开标定经纬度格式为DD°MM′SS″并在“标注”选项卡里把经纬度字体调成北京时间字体。这里有个很容易踩的坑“新建格网”要鼠标右键地图框才能看到入口而不是在菜单栏直接找有很多用户在这里卡住。6.3 拓扑查重叠批量删除重叠面最后处理一个高频需求——拓扑查重叠。Pro 里删除大量互相重叠的面如果人工逐个找效率太低。用以下脚本可以批量在要素类内部查找并删除重叠面import arcpy # 设置工作空间和输入要素 arcpy.env.workspace rD:\gis_data\your_geodatabase.gdb input_fc parcels_layer # 第一步用 Feature To Line 把面转成线重叠面会生成重复线段 lines arcpy.management.FeatureToLine(input_fc, temp_lines) # 第二步找出线段重叠的位置即面重叠的边界 dangles arcpy.management.FeatureVerticesToPoints(lines, temp_points, DANGLE) # 第三步用重叠点反向选中存在重叠的面 overlapped arcpy.management.SelectLayerByLocation(input_fc, INTERSECT, dangles, , NEW_SELECTION) # 第四步输出存在重叠的要素数量确认结果 count arcpy.management.GetCount(overlapped) print(f重叠面数量{count[0]})这段脚本的基本逻辑是面重叠时边的拓扑关系会产生悬挂节点这些节点坐标能反向定位到所有涉及重叠的面。执行前建议先备份数据因为删除操作不可逆。我在实际项目里被重叠面坑过一次当时有批土地利用数据里有三千多个重叠图斑直接开编辑器手工修到半夜。后来养成的习惯是任何矢量数据入库之前强制走一遍拓扑检查脚本。从那以后每次新装完 ArcGIS Pro 3.4我都会先跑一遍上面这三组验证确认环境干净了才开始干活。这套流程已经成了我重装机器后的固定动作省下来的时间都够多写两个工具了。希望帮到你。本文还有配套的精品资源点击获取