当前位置：资讯

基于Python的多系统QGIS二次开发环境配置方法探究

2023-01-29 17:01:17 来源:哔哩哔哩

主要内容：Windows和Ubuntu系统下的QGIS-python二次开发环境配置方法【过程超级无敌详细】

0 写在前面

最近在学习做水文模型二次开发，项目要用到QGIS-python做GIS平台，中间踩了不少坑。目前的教程大多是依赖于QGIS自带的编辑器或者是C++开发环境的配置，基于python的QGIS独立二次开发环境配置方面资料较少（因为太基础）。

(相关资料图)

经过相关资料的阅读、各种方法的对比和大佬的指导，在Windows 10系统和Ubuntu 22.04系统中分别尝试开发环境的配置。

现将Windows 10和Ubuntu 22.04系统下的QGIS-python开发环境配置过程总结归纳下来，以供交流。

1 Win10系统下QGIS-python的开发环境配置

1.1 方法一：使用QGIS软件中的bat文件直接配置环境

这种方法简单直接，也是资料书籍中推荐的配置方法，主要步骤如下：

step1：QGIS的下载及安装

在QGIS的官网(https://www.qgis.org/en/site/forusers/download.html)中提供了两种下载方式，分别是直接下载安装包和使用OSGeo4W进行依赖文件的下载。这里直接下载安装包进行安装，详细过程如下：

下载安装包，这里给出了一个最新版和一个LTR长期发行版，可以根据自己的需要进行选择：

下载得到后缀为.msi的安装包，按照步骤选择安装目录进行安装：

安装完成后打开QGIS程序文件夹，在./QGIS xx.xx/bin/目录下有个python-qgis.bat批处理文件，这个文件临时配置了python调用qgis库所需要的环境。

可以看到里面主要进行了以下几个路径的配置：

使用命令行检查qgis库是否可用：

1、打开命令行

2、切换到QGIS的bin目录下

3、在命令行中直接输入python-qgis.bat，进入QGIS下的python配置器

4、导入qgis库并运行，查看是否可用，没有报错，证明qgis库可用

可以在PyCharm中直接将python-qgis.bat作为python解释器进行项目开发。至此第一种方法介绍完成。

1.2 方法二：使用conda进行QGIS-python环境的配置

第一种配置方法虽然高效简单，但是只能借助QGIS自带的python解释器，并且在开发过程中进行其他的一些库的安装并不是很方便，还存在污染QGIS软件自身环境的风险。

最关键是的在做项目中有个库不用conda装不上（这个问题在ubuntu中并没有遇到），也就有了方法二的探索，即使用conda进行虚拟环境的构建以及QGIS-python环境的配置，详细步骤如下：

step1：Miniconda的下载及安装

目前用得比较多的有Anaconda和Miniconda，Miniconda仅包含了基础的conda和python依赖包，比较小，所以使用Miniconda。在Miniconda官网(https://docs.conda.io/en/latest/miniconda.html)，选择合适的版本进行下载，这里选择Miniconda3 Windows 64-bit版，其中conda的版本是22.11.1 ，python的版本是3.10.8。

根据安装提示逐步进行安装。

安装完成后打开命令行，输入conda，可能会弹出【'conda' 不是内部或外部命令，也不是可运行的程序或批处理文件】提示。

这是由于环境变量没有设置的原因。打开Miniconda的文件安装目录，复制condabin的位置：C:\ProgramData\miniconda3\condabin，打开【此电脑】-【属性】-【高级系统设置】-【高级-环境变量】找到系统变量下变量名为PATH的变量，点【编辑】将复制的condabin的位置添加进去。

重新打开命令行再输入conda info，可以看到conda配置完成

step2：创建虚拟环境

打开命令行，输入

在conda的默认目录下创建名为pyqgis_env的虚拟环境，在不指定python版本的情况下，python解释器版本和Minconda下载时的对应版本一致。

接着在命令行中输入

进入pyqgis_env虚拟环境

step3：python的QGIS库安装