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_OBJECT
public:
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 canvas
QgsMapCanvas *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 canvas
mapCanvas = 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文件打开，下图是效果展示(.shp 文件可以从QGIS官网下载)。
6. 其他问题
6.1 Qt插件未加载
在运行时可能会出现Qt插件未加载的情况。
此时找到QGIS安装目录中的D:\Software\OSGeo4W\apps\Qt5\plugins\platforms文件夹（根据自己的安装位置进行修改），将其复制到可执行文件(.exe)同一目录下即可。