1.系统要求

Windows10 专业版

2.安装Visual Studio 2015

从Visual Studio 官网找到自己需要的版本，并根据电脑位数、语言、文件类型进行下载，我下载的是Visual Studio Professional 2015 with Update 3。下载完成后点击程序进行安装。

如果只进行QGIS二次开发的话，在安装VS2015的时候选择自定义安装，只选择"Visual C++"即可。如下图所示。

根据自己需求进行安装，等待一段时间后安装完成。

2. 安装Qt5.12

在Qt官网的开源开发页面的下面找到Qt Online Installer，点击下载，然后安装。（下载需要Qt账号，需要提前申请一个账号）

点击在线安装后，根据自己需求选择安装位置等项目。在选择要下载的组件时，尽量选择LTS版本。下面是我安装时选择的组件。

其中MSVC 2015 64bit对应VS2015。如果是VS2017，可以选择MSVC 2017。

其余选项根据自己需求进行选择。等待一段时间后安装完成。

3. 安装QGIS3.16

在QGIS官网找到适合的下载版本，最好是下载QGIS in OSGeo4W在线安装器。这里以QGIS in OSGeo4W为例进行安装。

点击安装后选择Advanced Install，之后一路Next。直到选择下载网址。

选择一个网址进行下一步。然后在搜索框内输入qgis，显示所有的可安装组件，对于所有组件，都有Skip和相关版本，选择自己需要的就可以。这里是选择了所有3.16.16-1的组件。

之后进行下载，网速感人，需要相当长的时间。

4. 配置Visual Studio 2015 Qt插件

打开Visual Studio 2015，在"工具"->“扩展和更新”->“联机"中搜索"qt”，然后安装Qt插件。

重启软件后会在工具栏中找到"Qt VS Tools"，点击并找到"Options"->"Versions"进行Qt配置，配置文件夹以自己安装位置为准。

5. 运行QGIS程序

新建一个Qt项目"QGISTest"。

5.1 项目文件

main.cpp

#include "QGISTest.h"
//#include <QtWidgets/QApplication>
#include <qgsapplication.h>int main(int argc, char *argv[])
{QgsApplication a(argc, argv, true);// 这里的路径要改成自己的QGIS安装路径QgsApplication::setPrefixPath("D:/Software/OSGeo4W/apps/qgis-ltr-dev", true);QgsApplication::initQgis();    //初始化QGIS应用QGISTest w;w.show();return a.exec();
}

QGISTest.h

#pragma once#include <QtWidgets/QMainWindow>
#include "ui_QGISTest.h"#include <qmenu.h>
#include <qaction.h>
#include <qgsmapcanvas.h>class QGISTest : public QMainWindow
{Q_OBJECTpublic:QGISTest(QWidget *parent = Q_NULLPTR);private:Ui::QGISTestClass ui;private:// create the menus and then add the actions to them.QMenu *fileMenu;QAction *openFileAction;//map canvasQgsMapCanvas *mapCanvas;QList<QgsMapLayer *> layers;public slots:void on_openFileAction_triggered();//public:void addVectorLayer();
};

QGISTest.cpp

#include "QGISTest.h"
#include <qmenubar.h>
#include <qmessagebox.h>
#include <qfiledialog.h>
#include <qgsvectorlayer.h>QGISTest::QGISTest(QWidget *parent): QMainWindow(parent)
{//ui.setupUi(this);this->resize(600, 400);// create the menus and then add the actions to them.fileMenu = this->menuBar()->addMenu("File");openFileAction = new QAction("Open", this);this->connect(openFileAction, SIGNAL(triggered(bool)), this, SLOT(on_openFileAction_triggered()));fileMenu->addAction(openFileAction);// initialize the map canvasmapCanvas = new QgsMapCanvas();this->setCentralWidget(mapCanvas);mapCanvas->setCanvasColor(QColor(255, 255, 255));mapCanvas->setVisible(true);mapCanvas->enableAntiAliasing(true);
}void QGISTest::on_openFileAction_triggered()
{addVectorLayer();
}void QGISTest::addVectorLayer()
{QString fileName = QFileDialog::getOpenFileName(this, tr("Open shape file"), "", "*.shp");QStringList temp = fileName.split('/');QString basename = temp.at(temp.size() - 1);QgsVectorLayer* vecLayer = new QgsVectorLayer(fileName, basename, "ogr");if (!vecLayer->isValid()){QMessageBox::critical(this, "error", QString("layer is invalid: \n") + fileName);return;}mapCanvas->setExtent(vecLayer->extent());layers.append(vecLayer);mapCanvas->setLayers(layers);mapCanvas->refresh();
}

5.2 相关配置

5.2.1 附加包含目录

点击"Qt VS Tools"->“Qt Project Settings”->“C/C++”->“常规”，在附加包含目录中加入如下目录(根据自己的安装位置进行修改)。

D:\Software\Qt\5.12.12\msvc2015_64\include\QtXml
D:\Software\OSGeo4W\include
D:\Software\OSGeo4W\apps\qgis-ltr-dev\include

5.2.2 附加库目录

点击"Qt VS Tools"->“Qt Project Settings”->“链接器”->“常规”，在附加库目录中加入如下目录(根据自己的安装位置进行修改)。

D:\Software\Qt\5.12.12\msvc2015_64\lib
D:\Software\OSGeo4W\apps\qgis-ltr-dev\lib

5.2.3 附加依赖项

点击"Qt VS Tools"->“Qt Project Settings”->“链接器”->“输入”，在附加依赖项中加入如下内容。

Qt5Core.lib
Qt5Widgets.lib
Qt5Xml.lib
Qt5Gui.lib
qgis_core.lib
qgis_gui.lib
qgis_app.lib

5.2.4 预处理器定义

点击"Qt VS Tools"->“Qt Project Settings”->“C/C++”->“预处理器”，在预处理器定义中加入"_USE_MATH_DEFINES"，并与其他项用分号隔开。

5.2.5 环境变量

在系统环境变量path中加入如下目录(根据自己的安装位置进行修改)。

D:\Software\OSGeo4W\bin
D:\Software\OSGeo4W\apps\qgis-ltr-dev\bin
D:\Software\OSGeo4W\apps\Qt5\bin
D:\Software\OSGeo4W\apps\gdal-dev\bin
D:\Software\OSGeo4W\apps\proj-dev\bin

完成后重启。

5.3 运行结果

点击"File"->“Open”，然后找到 .shp文件打开，下图是效果展示。

6. 其他问题

6.1 Qt插件未加载

在运行时可能会出现Qt插件未加载的情况。

此时找到QGIS安装目录中的D:\Software\OSGeo4W\apps\Qt5\plugins\platforms文件夹（根据自己的安装位置进行修改），将其复制到可执行文件(.exe)同一目录下即可。