简介面向GIS学生、初级从业者及需快速搭建桌面端地理信息系统的用户这套ArcGIS Pro 3.4学习版安装教程附带可运行的基础代码入口围绕Esri官方最新版本展开兼顾性能升级与新功能亮点如从所选内容生成定义查询、3D切片共享、AI集成和高光谱影像支持能帮助读者缩短从下载到正式使用的上手路径。压缩包共3个文件体积约5KB核心为一篇HTML图文安装指引配合inscode在线运行配置与.gitignore版本管理辅助文件适合直接对照步骤操作也便于将示例代码迁移到本地开发环境。目前已有297人学习内容紧凑不臃肿既可作为GIS新手的安装参考也能为关注ArcGIS Pro二次开发的人员提供初始代码骨架省去从零搭建环境的时间。1. ArcGIS Pro 3.4 安装为什么一路点“下一步”的人一半会返工ArcGIS Pro 3.4 的安装看似简单下载、双击、下一步。可真到自己装的时候卡在进度条 90%、启动永远转圈、arcpy 导入直接报错的人不在少数。这篇笔记按“安装前准备 → 安装 → Python 环境 → 排错 → 验证”的顺序推进目标只有一个让你拿到安装包后一次装通并立刻用一份可运行源码证明环境真的可用。很多从 Anaconda、PyCharm 那套安装习惯切换过来的用户最容易低估许可模式和磁盘目录这两个暗坑而它们恰恰决定了后续能否稳定跑数据。2. 装之前先确认三件事硬件底限、许可模式和磁盘边界2.1 ArcGIS Pro 3.4 对硬件和 Windows 版本的真实要求ArcGIS Pro 3.4 只支持 64 位 Windows这点和旧版 ArcMap 的 32 位兼容时代完全不同。操作系统层面Windows 10 22H2/21H2、Windows 11 以及 Windows Server 2019/2022 都在支持范围内且系统必须是 64 位版本。装在一台 32 位系统上安装程序会直接拒绝运行这是最容易被忽略的第一道门槛。硬件配置上官方写的“最低要求”和实际干活是两回事。内存 8GB 只能说是能打开软件加载一个稍大的矢量图层就开始吃力16GB 是日常编辑和制图的起步线做栅格分析或跑深度学习模型建议直接上 32GB。CPU 多核收益明显尤其是缓冲区、相交这类几何运算密集的工具核心数比频率更影响体感。显卡方面DirectX 11 是硬性要求集成显卡能跑但切换场景会明显卡顿独显至少 4GB 显存才谈得上流畅预览 3D 场景。项目最低要求推荐配置系统Windows 10/11 64 位Windows 11 64 位内存8 GB16 GB 以上CPU双核 x64六核以上显卡DirectX 11 兼容独立显卡 4GB 显存磁盘安装占用约 15 GB预留 50 GB 以上磁盘占用是很多人算漏的账安装目录本身十几 GB但 ArcGIS Pro 会在 %LOCALAPPDATA% 和用户文档目录里大量写入缓存、日志和默认工程文件加上 Python 环境里常用包的解压缓存C 盘空间会以肉眼可见的速度缩水。建议 C 盘预留至少 50GB 可用空间否则装完跑不了几天就会出现“写入失败”这类莫名其妙的报错。2.2 Named User、Single Use 和官方试用许可该选哪一种ArcGIS Pro 3.4 不是开源软件没有“装完就能永久用”的说法许可模式必须在安装前想清楚。它主要有三种正规授权路径Named User、Single Use 和官方试用。选错模式往往不是装不上而是装完打不开或者几天后被锁定返工成本极高。Named User 是最常见的授权方式单位购买 ArcGIS Online 或 Portal for ArcGIS 的组织账号你在安装完成后用账号登录许可跟着账号走换电脑也能快速恢复。这种模式的缺点是必须联网断网环境下登录不了就进不去主界面。Single Use 则是把许可绑定到一台机器上通过许可证文件授权适合离线办公环境但换机器需要在旧机器上先释放许可否则授权次数会被占用。官方试用适合个人评估注册普通 ArcGIS Online 账号即可申请 21 天全功能试用装完用账号登录就能用评估完过期再决定是否采购。许可模式离线能力适合场景注意事项Named User需要联网单位团队协作登录后许可跟随账号Single Use支持离线内网/保密环境换机前要先释放许可官方试用需要联网个人评估、学习21 天全功能安装到中途时安装程序会问你用哪种许可模式这里据实选就行。选了 Named User 之后在启动界面登录账号选了 Single Use 则要指向许可文件。别在没确认组织账号是否开通 ArcGIS Pro 权限的情况下就选 Named User我见过不少人装完后登录自己的免费账号结果提示“没有可用许可”折腾半天发现是账号不对。2.3 C 盘默认路径为什么是第一个雷默认安装路径是C:\Program Files\ArcGIS\Pro这个位置本身没问题真正的问题是用户目录。安装时如果 Windows 用户名是中文比如C:\Users\测绘部老张后面创建工程、存放临时数据都会碰到路径编码问题尤其影响 Python 脚本里对路径字符串的处理报错信息还特别隐晦。常见做法是安装时把程序目录改到非系统盘例如D:\ArcGIS\Pro同时保证 Windows 用户名是英文。如果当前用户名已经是中文与其折腾改系统用户名会连带一堆权限问题不如新建一个英文管理员账户来做 GIS 相关工作。另外ArcGIS Pro 的默认工程目录位于“文档”文件夹下建议在设置里把默认工程位置改到和数据盘一致的位置避免 C 盘和 D 盘之间反复拷贝工程文件。安装包本身也要放在一个纯英文路径下比如D:\software\ArcGISPro_34.exe放在中文路径或含空格的目录可能导致自解压阶段失败。这些细节在安装阶段看起来无关紧要却和后面的 arcpy 运行稳定性直接相关。3. ArcGIS Pro 3.4 安装完整流程图形向导与静默安装两条路3.1 下载与校验别让解压中断毁掉半小时安装包从 My Esri 下载中心或者官方试用页面获取文件名一般是ArcGISPro_34.exe体积好几个 GB走公司内网下载还好走公网就很容易出现下到一半断掉的情况。下载完成后先别急着双击用哈希校验确认文件完整性。用 PowerShell 计算 SHA256Get-FileHash .\ArcGISPro_34.exe -Algorithm SHA256 | Format-List计算出的哈希值要和下载页面给出的值逐位比对不一致就重新下载。这一步看起来多余实际能省掉大量排错时间我遇到过安装到 90% 失败反复多次无果最后发现是下载文件损坏重新下载一次直接装通。文件完整性确认后把安装包移到英文路径准备开始安装。这个步骤的核心逻辑是“先验证再动手”哈希校验是确认安装包从服务器到本地磁盘的过程没有发生损坏参数选择 SHA256 是因为它比 MD5 抗碰撞能力更强ArcGIS 官方也普遍用 SHA256 发布校验值。比对时重点看前几位和后几位是否一致完整对比当然更稳妥。3.2 图形向导安装从 Setup 到首次启动双击ArcGISPro_34.exe安装程序会先自解压然后进入图形向导。第一屏是许可协议勾选接受后进入许可模式选择。这里按第 2 章确定的方案选如果是在单位内网用组织账号选 Named User如果离线环境选 Single Use 并准备好许可文件。下一步是选择安装目录和组件。组件方面默认全选即可包括 ArcGIS Pro 主体和 Python 环境。你可能会看到“安装 Python 环境”这个选项千万别取消勾选——后面跑 arcpy 全靠它。安装选项里还有“创建桌面快捷方式”和“允许安装软件更新需连接到 Internet”两项前者建议勾上后者根据内网策略决定。点击安装之后是漫长的等待进度条走到后期会有一段时间看起来像卡住了其实是在配置 Python 环境和系统组件。安装日志默认写到%TEMP%\ArcGISProInstall目录如果中途失败去这个目录看日志比猜进度条可靠得多。安装完成后向导会让你决定是否立即启动 ArcGIS Pro。首次启动会进入登录界面输入 ArcGIS Online 账号或组织 Portal 地址。登录成功后软件会自动匹配许可正常进入主界面。首次启动会比后续慢因为要生成用户配置和初始化默认工程模板多等一两分钟是正常的。3.3 静默安装给批量部署留一条路如果要在十几台培训机器上部署同一套环境图形向导就太慢了。ArcGIS Pro 3.4 的安装包支持静默安装常见做法是把安装包用自解压方式解出 MSI 文件再用msiexec带参数执行。我一般在测试环境先手动装一台确认参数可行后再推到批量机器。msiexec /i ArcGISPro.msi /qb INSTALLDIRD:\ArcGIS\Pro这里的/qb表示显示基本进度条但不弹交互窗口适合推送部署时让现场人员能看到进度。INSTALLDIR指定安装目录必须是一个已存在的英文路径D:\ArcGIS\Pro这种写法最稳。参数后面如果追加BLOCKADDINS1可以禁用加载项安装这在统一管控的实训机上有用但多数场景不必加。静默安装完成后不会自动启动软件也不会自动登录账号必要的话在静默命令后追加一条启动命令让用户首次登录自行完成授权。批量部署时还要注意所有机器的系统用户名都应该遵循统一英文命名规则否则第一台装通、第二台就可能在 Python 环境初始化时报错。静默安装适合的是“程序文件统一”许可和用户数据仍然要逐台处理别指望一条命令解决所有问题。4. 把 Python 环境跑起来arcpy 即装即测的最小源码4.1 ArcGIS Pro 3.4 自带 Python 环境的结构ArcGIS Pro 3.4 内置的是一个独立的 Python 3.9 环境环境名固定叫arcgispro-py3它和系统里装的 Anaconda、系统 Python 互不干扰。这个环境位于安装目录下C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3里面预装了 numpy、pandas、matplotlib 等常用科学计算包更重要的是装了 arcpy——ArcGIS 的 Python 入口。如果你在安装时取消了 Python 组件后续会发现「开始菜单里的 Python 命令提示符」消失了arcpy 更无从谈起。碰到这种情形只能重装或修复安装。ArcGIS Pro 在开始菜单里自带两个快捷方式一个是“Python”点开是命令行环境另一个是“Python 3.9ArcGIS Pro”打开后同样进入该环境。两者本质相同只是命名差异。用自带 Python 命令提示符看一眼环境conda env list输出会列出本机所有 conda 环境正常情况下至少包含arcgispro-py3和base。如果看不到arcgispro-py3说明 Python 组件没装全或者路径被改动。这个命令是用来确认“环境存在”真正能不能用要看 arcpy 能否导入。4.2 用 5 行代码验证 arcpy 能跑安装是否成功最硬核的验证方式是运行一段真正调用 arcpy 的代码。启动 ArcGIS Pro 自带的 Python 命令提示符输入以下内容import arcpy print(ArcGIS Pro 版本:, arcpy.GetInstallInfo()[Version]) print(Python 版本:, arcpy.GetPythonInstallInfo()[PythonVersion]) print(arcpy 路径:, arcpy.__file__)逻辑说明第一行导入 arcpy如果这一步报错说明环境损坏或路径不对。GetInstallInfo()返回安装元数据Version键对应产品版本号比如 3.4.x。GetPythonInstallInfo()返回运行时信息PythonVersion显示实际生效的解释器版本。arcpy.__file__则直接打印出 arcpy 包所在的物理路径确认当前用的是 Pro 自带环境而不是误入了别的 Anaconda 环境。如果这段代码能逐行正常输出说明安装最核心的部分——引擎和 Python 绑定——全部就绪。常见的失败形态是ModuleNotFoundError: No module named arcpy几乎都是因为用了系统 Python 或 Anaconda 的默认终端运行而不是通过 ArcGIS Pro 的 Python 快捷方式进入。换用自带终端后同样代码往往直接通过。验证完这一步安装才算是过了 60% 的关卡。4.3 独立 conda 环境别污染本体arcgispro-py3是 ArcGIS Pro 的运行基础不建议在里面乱装包尤其是安装需要编译的库或版本冲突的包一旦损坏重装成本很高也影响业务系统稳定性。更稳妥的做法是基于它克隆一个专用环境把项目依赖装到副本里。conda create --clone arcgispro-py3 --name mypro_env克隆完成后后续用conda activate mypro_env进入自己的环境。参数含义--clone指定源环境克隆会复制已装包和配置--name给新环境命名mypro_env可以换成项目名。克隆操作需要一点时间因为要复制大量文件几十秒到几分钟都正常。克隆环境时要特别注意--clone复制的是包本体arcpy 的授权校验依赖 ArcGIS Pro 的安装信息所以即便在克隆环境里import arcpy 依然需要机器上有正常的 ArcGIS Pro 安装和授权。换句话理解环境可以随便克隆但授权始终绑在软件本体上。我一般只为真实项目克隆环境临时验证脚本直接用自带的arcgispro-py3既省磁盘又少踩环境不一致的坑。5. 避坑ArcGIS Pro 3.4 安装最常见的 5 个翻车现场5.1 现象安装进度条卡在 90% 不动安装向导走到 90% 附近时界面长时间不动很多人以为死机了直接强制重启结果再次安装时提示“已有部分安装信息请先卸载”。原因这个阶段正在配置 Python 环境和系统组件耗时跟机器性能和杀毒软件的实时扫描强度直接相关。Windows Defender 或其他杀毒软件在扫描正在写入的 Python 脚本文件时会导致安装线程被挂起很久。解决先等 10 分钟以上观察 CPU 和磁盘活动如果还有读写就说明没死。如果确认是杀毒拦截把安装目录和%LOCALAPPDATA%\ESRI加入杀毒软件的白名单/排除项再重新执行安装。不要直接关掉防护排除目录的方式更安全也避免反复触发。装完后再检查一次排除项是否生效。5.2 现象启动后一直转圈进不了主界面第一次启动时出现启动画面接着光标一直转圈主界面迟迟不出来过一会儿弹出“许可不可用”或“无法连接服务器”。原因绝大多数情况是许可模式与账号不匹配。选了 Named User却用没有 ArcGIS Pro 权限的账号登录或者单位 Portal 地址填错导致授权服务器无法访问。解决退出启动流程核对账号和许可。如果单位用的是 Portal登录界面要填完整的 Portal URL而不是只填用户名。如果 Single Use 模式检查许可文件路径是否正确、授权是否过期。另一种常见原因是显卡驱动太老导致 3D 渲染初始化失败去显卡官网更新驱动后再启动。这个问题的排查顺序是先看账号权限再看网络连通性最后看显卡驱动。5.3 现象arcpy 导入报 ModuleNotFoundError在 Visual Studio Code 或 PyCharm 里运行脚本import arcpy直接提示找不到模块。原因IDE 默认使用的解释器是系统 Python 或 Anaconda 的 base 环境这些环境里没有 arcpy。arcpy 只存在于 ArcGIS Pro 自带的 Python 环境不是普通 pip 包不能靠pip install补上。解决把解释器切换为C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe。在 VS Code 里按CtrlShiftP选择解释器手动浏览到该路径PyCharm 则在 Settings 里添加该解释器。切换后重新运行问题会直接消失。如果依然报错检查环境目录下Lib\site-packages\arcpy是否存在文件缺失就只能修复安装。5.4 现象卸载重装后许可被占用机器上卸载了 ArcGIS Pro换一台电脑或重装系统后Single Use 许可提示“授权被占用”或“已达到最大激活次数”。原因Single Use 许可绑定机器卸载软件之前没有先释放授权导致该设备仍占用一个授权的名额。解决在旧机器上启动 ArcGIS Pro进入许可授权界面执行“释放许可”操作确认释放后再卸载。如果旧机器已经无法开机联系单位的许可管理员重置授权名额。重装系统前务必将释放许可这一条写进流程清单它和备份数据一样重要。5.5 现象运行时提示 .NET 组件不兼容安装完成后启动软件提示缺少某个 .NET Runtime或者程序启动即闪退。原因ArcGIS Pro 3.4 的某些功能依赖对应版本的 .NET Desktop Runtime系统里的 .NET 组件版本和它要求的不一致多见于Ghost 精简版系统或老版本 Windows 镜像。解决让安装程序自动处理组件前不要手动预装多个版本的 .NET版本冲突反而更麻烦。如果闪退检查系统更新里是否有未完成的 .NET 补丁重启系统后再启动软件。企业内部批量部署时先在基准镜像上验证一次安装确认无误后再推广到全环境能避开九成以上的系统组件问题。6. 装完立即验证一份可运行源码把安装变成项目起点6.1 用完整自检脚本验证整套环境前面的最小验证只确认了 arcpy 能导入但磁盘读写、几何运算、空间分析这些能力还没验证。我会在每台新机器上跑一遍完整的自检脚本——这套脚本也是标题里说的“可运行源码”的落地形式装完即有、能跑、可复用。# -*- coding: utf-8 -*- ArcGIS Pro 3.4 安装自检脚本验证环境、数据读写与空间分析。 import os import arcpy # 1. 版本信息 print(ArcGIS Pro:, arcpy.GetInstallInfo()[Version]) print(Python :, arcpy.GetPythonInstallInfo()[PythonVersion]) # 2. 在工作目录创建文件地理数据库 gdb_path os.path.join(os.environ[USERPROFILE], Documents, 安装自检.gdb) if not arcpy.Exists(gdb_path): arcpy.CreateFileGDB_management( os.path.dirname(gdb_path), os.path.basename(gdb_path).replace(.gdb, )) # 3. 创建点要素类并写入两个点 fc os.path.join(gdb_path, check_points) if not arcpy.Exists(fc): arcpy.CreateFeatureclass_management(gdb_path, check_points, POINT) with arcpy.da.InsertCursor(fc, [SHAPEXY]) as cursor: cursor.insertRow([(126.5, 45.2)]) cursor.insertRow([(127.0, 45.8)]) # 4. 执行缓冲区分析验证空间分析引擎 buffer_fc os.path.join(gdb_path, buffer_result) arcpy.analysis.Buffer(fc, buffer_fc, 1000 Meters) # 5. 输出结果 count int(arcpy.GetCount_management(fc).getOutput(0)) print(点要素数量:, count) print(缓冲区生成:, arcpy.Exists(buffer_fc)) print(自检通过)代码说明第一步打印版本信息确认引擎与 Python 绑定第二步创建文件地理数据库验证磁盘写入权限第三步创建点要素类并通过SHAPEXY插入坐标验证要素类创建和数据写入第四步调用Buffer工具验证空间分析模块能正常跑通。CreateFileGDB_management的第二个参数是数据库名传入时不能带.gdb后缀。Buffer 的1000 Meters必须带单位字符串否则工具会拿默认单位去算结果可能不符合预期。运行方式很简单把源码保存为check_install.py在 ArcGIS Pro 自带的 Python 命令提示符里执行python check_install.py。脚本顺利走完并输出“自检通过”这台机器的安装才算真正落地。6.2 把自检脚本固化成项目模板这份脚本不只能验证一次稍微改改就能当成每个新项目的环境初始化模板。我会保留前四步把后面替换成目标项目要做的第一个真实操作比如创建要素数据集、导入矢量数据或者跑一次裁剪。这样每开一个新项目先跑一遍初始化脚本环境有没有问题在动手前就暴露出来而不是在项目做到一半时爆发。有一个习惯保持了很久每次装完 ArcGIS Pro我都会在桌面放一个“环境自检”文件夹里面只有安装包校验值截图和这份脚本。原因很实际——3 个月后某天软件突然出问题任何人都能快速判断是环境坏了还是数据坏了而不是在论坛里从头搜一遍报错。希望这套验证思路也能帮到你。本文还有配套的精品资源点击获取