ArcGIS Pro 安装 Python 第三方库的三种方法

包管理器 · pip 命令行 · Notebook —— 从安全到便捷，总有一种适合你

目录

1.方法一：包管理器 —— 克隆环境后安装（推荐）

2.方法二：找到 ArcGIS Pro Python 路径，使用 pip 安装

3.方法三：在 Notebook 中直接安装

4.三种方法对比总结

5.常见问题 FAQ

6.下一步学习路径

ArcGIS Pro 自带 Python 环境（arcgispro-py3），本文介绍三种安装第三方库的实用方法：包管理器克隆环境安装（推荐，最安全）、命令行 pip 安装（灵活直接）、Notebook  内安装（快速便捷）。

你将学到什么

·掌握 ArcGIS Pro 包管理器克隆环境并安装第三方库

·找到 ArcGIS Pro Python 路径并用 pip 命令行安装

·在 Notebook 中直接执行安装命令

·了解每种方法的优缺点和适用场景

前置要求

·已安装 ArcGIS Pro 2.5 及以上版本

·基本的 Python 命令行操作概念

·了解 pip 包管理工具的基础知识

方法一：包管理器 —— 克隆环境后安装（推荐）

这是最安全、最推荐的方式。ArcGIS Pro 内置的包管理器可以克隆默认环境，在克隆环境中安装第三方库不会影响原始环境。

Step 1：打开包管理器

在 ArcGIS Pro  中，点击顶部菜单项目（Project） → Python，打开 Python 包管理器界面。

Step 2：克隆默认环境

1.点击管理环境（Manage Environments）按钮

2.选中 arcgispro-py3（默认环境），点击克隆（Clone）

3.为克隆环境命名，例如 arcgispro-py3-myenv

4.等待克隆完成（通常需要 3~10 分钟，视磁盘速度而定）

Step 3：激活克隆环境

克隆完成后，在环境列表中选择刚创建的克隆环境，点击右侧的激活按钮，将其设为当前活动环境。

Step 4：安装第三方库

1.在包管理器界面，确保当前活动环境是克隆环境

2.点击添加包（Add Packages）按钮

3.在搜索框中输入要安装的库名，如 requests、 pandas、shapely

4.选中目标库，点击安装（Install）

5.确认依赖项后，点击应用（Apply），等待安装完成

优缺点

方法二：找到 ArcGIS Pro Python 路径，使用 pip 安装

如果你习惯命令行操作，可以直接定位 ArcGIS Pro 自带的 Python 解释器，用 pip 安装库。

Step 1：找到 Python 解释器路径

ArcGIS Pro 的 Python 位于安装目录下的bin/Python/envs/  路径中。不同版本的默认路径略有差异：

如果安装时修改了路径，可在 ArcGIS Pro 的项目 → Python页面查看确切路径。

Step 2：打开命令行窗口

按 Win + R，输入 cmd，回车打开命令提示符。建议以管理员身份运行以避免权限问题。

Step 3：使用 pip 安装第三方库

# 进入 ArcGIS Pro Python 目录          
cd "C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3"          

# 安装单个库          
python.exe -m pip install requests          

# 安装指定版本          
python.exe -m pip install pandas==2.1.0          

# 批量安装多个库          
python.exe -m pip install numpy scipy matplotlib

注意：务必使用 python.exe -m pip install 而非直接 pip install，确保调用的是 ArcGIS Pro 环境的 pip，而不是系统中其他 Python 的 pip。

Step 4：验证安装

# 查看已安装的包列表          
python.exe -m pip list          

# 验证特定库能否正常导入          
python.exe -c "import requests; print(requests.__version__)"

如果遇到权限问题

若安装时报 Permission denied 错误，有两种解决方式：

# 方式 A：以管理员身份运行 cmd 后重新执行安装命令          

# 方式 B：安装到当前用户目录（无需管理员权限）          
python.exe -m pip install --user requests

  使用 --user 参数安装后，库会安装到用户目录而非 ArcGIS Pro 环境目录，但在 ArcGIS Pro 的 Python 窗口中仍可正常导入使用。

优缺点

方法三：在 Notebook 中直接安装

ArcGIS Pro 内置 Jupyter Notebook 支持，在 Notebook 单元格中执行安装命令即可安装第三方库，无需离开 ArcGIS Pro  界面。

Step 1：打开 Notebook

在 ArcGIS Pro 中，点击分析（Analysis）选项卡 → Python组 → Notebook，选择新建 Notebook。

Step 2：在单元格中安装库

在 Notebook 的第一个单元格中输入并执行：

# 安装单个库          
!pip install requests          

# 安装多个库          
!pip install pandas openpyxl shapely

感叹号 !是 Jupyter 的魔法命令（magic command），表示在系统 shell 中执行后续命令。

Step 3：导入并使用

在新单元格中导入刚安装的库即可使用：

import requests          
import pandas as pd          

print(f"requests 版本: {requests.__version__}")          
print(f"pandas 版本: {pd.__version__}")

输出示例：

requests 版本: 2.31.0          
pandas 版本: 2.1.0

扩展：使用 %pip 魔法命令（更可靠）

在某些环境下，!pip可能调用到其他 Python 环境的 pip。更保险的做法是使用%pip：

# %pip 确保调用当前 Notebook 内核关联的 pip          
%pip install requests

两者区别：

优缺点

三种方法对比总结

常见问题 FAQ

以下是使用 ArcGIS Pro 安装 Python 第三方库时经常遇到的问题及解决方案。

Q1：安装时提示 SSL certificate verification failed 怎么办？

这通常是因为网络代理或防火墙导致。可尝试：

python.exe -m pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org 库名

或在 pip.ini 配置文件中添加可信主机。

Q2：安装后 import 报 ModuleNotFoundError？

检查是否安装到了正确的 Python 环境。在 ArcGIS Pro 的 Python 窗口中执行：

import sys          
print(sys.executable)  # 确认当前使用的 Python 路径

确保该路径与 pip 安装的目标路径一致。

Q3：ArcGIS Pro 自带的库（如 numpy、pandas）能升级吗？

  不建议直接升级 ArcGIS Pro  自带的核心库，可能导致 ArcGIS Pro 功能异常。如需使用新版本，请克隆环境后再升级。

Q4：克隆环境失败怎么办？

确保磁盘空间充足（至少 5GB），关闭杀毒软件后重试。也可在命令行中用 conda 克隆：

conda create --clone arcgispro-py3 --name myenv

下一步学习路径

·学习使用 conda 管理 ArcGIS Pro 多环境

·掌握 ArcPy 站点包的使用和扩展

·探索在 ArcGIS Pro 中使用深度学习框架（PyTorch、TensorFlow）

元信息

目标读者：ArcGIS Pro 用户，有基础 Python 使用经验

前置知识：了解 Python pip 基本概念

适用版本：ArcGIS Pro 2.5+

预计阅读时间：10  分钟