QGIS 3.14插件开发——Win10系统PyCharm开发环境搭建四步走
前言：最近实习要求做一个QGIS插件，网上关于QGIS 3.14插件开发环境搭建的文档不多，而且也不算太全面。正好实习的时候写了一个文档，在这里给大家分享一下。
因为是Word转的Markdown，可能文章格式略有问题，不过没关系啦（。）
一、PyQGIS安装
在windows系统下，QGIS安装包会自动安装PyQGIS模块，本文以windows系统进行讲解。
实际上，如果使用新版本的QGIS for
Linux或Mac也会安装PyQGIS，可以参考QGIS官方文档。
二、Python环境变量配置
（1）配置Path
配置Python环境变量主要是为了从命令行运行python和调用pyqgis库。
先设置系统变量path，最好是放到最前面，防止被其他地方安装的python覆盖，如：
操作过程如系列图：此电脑（右键）—―属性→系统——高级系统设置→系统属性——环境变量→环境变量|系统变量
在系统变量中找到Path，点击编辑
添加环境变量：
D:\QGIS 3.14\bin
D:\QGIS 3.14\apps\qgis\bin
D:\QGIS 3.14\apps\Qt5\bin
(其中D:\QGIS 3.14 是你QGIS的安装位置)
（2）配置PYTHONPATH
PYTHONPATH主要是为了让Python能够找到PyQGIS的各种依赖模块，保证正常使用。
在系统变量中点击新建，新增名为PYTHONPATH系统变量。
变量值设置为：
D:\QGIS 3.14\apps\Python37;
D:\QGIS 3.14\apps\qgis\bin;
D:\QGIS3.14\apps\qgis\python;
D:\QGIS 3.14\apps\Python37\lib;
D:\QGIS 3.14\apps\Python37\Lib\site-packages;
D:\QGIS 3.14\apps\Python37\DLLs;
D:\QGIS 3.14\apps\Python37\Scripts;
（其中D:\QGIS 3.14是你的qgis安装路径,python37是qgis自带python的版本）
、
（3）检查环境变量配置是否成功
Win+r 打开运行窗口，输入cmd启动命令提示行
输入python3或者python，运行python。该python版本应为qgis自带python版本。
然后输入：
import qgis.core
import qgis.user
import qgis.gui
import console
没有提示错误即为配置成功
三、使用QGIS构建插件项目
插件安装和构建插件项目的流程如下：
（1） 插件安装
打开QGIS，插件——
因为我们后面使用PyCharm开发，QGIS中Remote Debug这个工具可有可无。
（2）插件路径设置
在QGIS的设置-选项-系统中，找到环境一栏，勾选“使用自定义变量”，添加插件工作区路径。之后的插件需要生成到这个路径下，QGIS才能自动识别到。
例如我设置为：E:\QGIS_plugin_develop
（3）创建插件
https://www.osgeo.cn/qgisdoc/docs/pyqgis_developer_cookbook/plugins/index.html
创建插件工程
重新启动QGIS
这里的Class name是插件的类名，Plugin name是你的插件名，Moule
name是python模块的名称。如果只是开发练习，后面那些乱七八糟的随便填就好。
如果不想发布插件，只做练习使用，这里建议大家勾选Flag the plugin as
experimental选项
这里选择之前设置的插件工作区的路径，自动生成的插件模板就会放置于该目录下。
：
为了避免不必要的麻烦。插件生成完毕后，先不要加载插件，否则会提示缺少：
resources.py 文件
如果弹出以下对话框，也暂时先不管，咱们之后再处理。
这样插件项目模板创建好了，可以在刚才我们创建的目录下查看
四、搭建PyCharm开发环境
PyCharm有两种版本，一种是免费的Community版，一种是Professional版。
其中Pycharm Community版本不支持Remote
Debug。如果想要使用Pycharm的远程调试功能调用Pydev包（Pydevd-pycharm）进行调试，就需要安装Professional版本。
JetBrains全家桶提供了学生授权供学生免费使用。只要使用大学的邮箱在其官网注册一个账号，然后申请学生授权就可以免费使用JetBrains的所有产品。
参考：https://jingyan.baidu.com/article/acf728fd862d44f8e510a385.html
当然，如果觉得自己不需要用到调试功能，下载Community版本也可。下面以Community版本讲解PyCharm的环境搭建。Professional版本的搭建过程也是一样的。
安装Pycharm Community流程，如下：
（1） 下载
官方网站 https://www.jetbrains.com/pycharm/
选择保存后，等待下载。
找到下载文件
（2）安装
双击安装文件。
选择安装目录，Pycharm需要的内存较多，建议将其安装在D盘或者E盘，不建议放在系统盘C盘：
create desktop
shortcut（创建桌面快捷方式）：系统32位就选32-bit,系统64位就选64-bit。现在大多数都是64位了，不清楚系统类型：我的电脑=》右键=》属性
update path variable(restart needed)更新路径变量(需要重新启动)：add launchers
dir to the path（将启动器目录添加到path中）。这里我建议大家添加到环境变量PATH。
update context menu（更新上下文菜单）：add open folder as
project（添加打开文件夹作为项目）。可以不选。
create associations 创建关联：关联.py文件，双击都是以pycharm打开。
（3）PyCharm python解释器设置
打开安装好的PyCharm：
设置UI颜色
直接下一步即可
这里选择Open打开我们之前生成插件项目。然后File-Settings打开设置
打开设置后，找到python interpreter，点击右上角的设置Add
选择System Interpreter（这里不推荐大家自己构建虚拟环境），添加Python解释器：
D:\QGIS 3.14\apps\Python37\python.exe
（其中D:\QGIS 3.14是你的安装路径）
可以看到，PyCharm已经帮我们把相关的包引入进来了
（4）安装扩展工具
在Settings中选择Tools打开External Tools页面，点击+号添加扩展工具。
添加QtDesigner，用于编辑UI
Name：QtDesigner
Program：D:\QGIS 3.14\apps\Qt5\bin\designer.exe
Working directory：你的插件项目的目录
添加PyUIC（UI转换工具），用于将ui转换为py模块
Name：Pyuic
Program：D:\QGIS 3.14\apps\Python37\Scripts\pyuic5.bat
Arguments: $FileName$ -o $FileNameWithoutExtension$.py
Working directory：你的插件项目的目录
（其中Arguments相当于一段控制台命令，是调用pyuic5.bat的参数）
添加PyRCC（资源转换工具），用于将qrc转换为py模块
Name：Pyrcc
Program：D:\QGIS 3.14\apps\Python37\Scripts\pyrcc5.bat
Arguments: $FileName$ -o $FileNameWithoutExtension$.py
Working directory：你的插件项目的目录
（这里的Arguments也是同样的道理）
（5）创建resources.py和图形界面py文件
创建图形界面py文件：
找到项目目录下，扩展名为ui的文件（文件名根据你设置的插件模块名有所不同），右键External
Tools-Pyuic运行扩展工具
没有报错，并且在项目目录下出现同名的py文件则为转换成功。
同理，对resources.rcc的文件，右键选择右键External Tools-Pyrcc
（6）运行插件
万事俱备，打开QGIS，插件栏选择管理并安装插件。
在已安装的插件中找到并勾选我们的插件，然后运行我们的插件即可。
