qgis与qt开发基于vs环境搭建（傻瓜式教程）
嗯，本人因为工作需要所以耗费一些事件摸索着如何搭建这个环境，感觉网上的资料不多，自己找起来也很麻烦，因为是第一次本人踩了不少坑，所以留下这个搭建教程，希望能帮助一些人。
一 正文
进入qgis下载官网,Download · QGIS Web Site,跳过捐赠选项可以直接进入下载 这里选择的是installer 在线下载
下载好之后，右键以管理员身份打开在线安装器，osgeo4w-setup.exe。
需要我们自己选择安装文件，所以选择高级
选择安装路径，这个路径要记录下来，能够让你自己找得到
如果不以管理员身份打开，无法选择all users
这个路径也是同样需要记录，这里存放的主要是缓冲文件。
这里讲一讲我遇到的问题：因为需要请求的数据在国外，所以之后步骤里，在线安装器下载的十分缓慢，而国内的镜像站还都没有资源，部分大文件下载很慢的时候不是你多等一会他就会下载好，而是很大几率崩溃，哪怕是下载好，他也会无法使用甚至报错。
这里有两个解决办法，一个是从官方文档里下载你所需要的大文件，然后放在缓冲目录的指定目录下，至于放在哪个目录，你需要去你设置的缓冲文件夹里查找需要的，对应压缩包，目前下载的文件放在哪，你就可以将大文件放在那里，然后重新进行安装。
上面这个解决办法很难办，到后来要下载的大文件太多，太杂，部分还无法识别，看个人情况。
第二种解决方法就要简单很多，我是在凌晨一点左右的时候进行下载，这时间内国内使用数据流量的人数不多，网络运营商分配的流量通道也更大，所以下载国外数据也很快。
个人认为第二种方法比较容易一点。
这里的下载路径可以任选，有的地方第二种速度很快，有的地方第一种速度快。
下面是需要安装的东西。
点击skip就可以选中下载
下面是选择完gdal之后我下载的，当时因为下载速度太慢去官网下载的大文件压缩包
要注意，这里也有大问题。
尽量选择在这个在线下载器里面安装qt，并且版本只能是qt5，目前qgis对qt6还不太适配，作者当时花费半天时间搭建qt6与qgis，但是无论怎么尝试都会报错，我这里怀疑应该是接口搭配的不太对，无法调用。
如果你实在是想自己下载qt也尽量选择在线下载器里面的版本，能够确保适配。
这里就不一一展示下去了，每个人需要的库文件不同，我这个是进行基本开发时没什么问题，能够运行tif格式文件
接下来就是一直点一些同意协议之类的，然后到下载这一步，他会自动安装一些额外需要的依赖项之类的东西
大部分缓冲文件都会放在这个release文件夹里面。
安装结束，开始vs环境搭建。
vs环境搭建，首先你要确保已安装Qt VS Tools插件（扩展 → 管理扩展 → 搜索Qt安装）
点击继续但无需代码，我这里是下载好了的
配置环境变量。
以下都需要查看你自己的路径！！！！！！！！！！！！！！
在你的path环境路径下，加上这些库文件，主要是使得代码运行时候能够找到对应库，使用头文件。注意：你要查看你自己的文件安装在哪
设置好环境变量记得重启。
之后
打开 Visual Studio 2022。
确保已安装 Qt VS Tools 插件（扩展 → 管理扩展 → 搜索Qt安装）。
点击菜单栏 “扩展” → “Qt VS Tools” → “Qt Versions”。
点击 “Add” 按钮：
Version name：输入
Qt5-OSGeo4WPath：浏览到
D:\OSGeo4W\apps\Qt5\bin\qmake.exe
点击 “OK” 保存。列表中应出现该版本，左侧有绿色对勾表示默认。
接下来，我们就可以创建qt项目了
下面这部分需要点击debug旁边的红色减号 目前qgis不支持debug 会报错
首先确保自己能够正确运行，如果没运行请检查环境变量，以及vs拓展下载问题
配置项目属性（核心）
右键项目 →“属性”，在左上角将“配置”设为“所有配置”，“平台”设为“x64”。
添加 Qt XML 模块
进入“Qt Project Settings”，在“Qt Modules”文本框中追加;xml，使其变为：
core;gui;widgets;xml
附加包含目录（头文件路径）
进入“C/C++” → “常规” → “附加包含目录”，将以下一行内容完整复制进去：
D:\OSGeo4W\include;D:\OSGeo4W\apps\qgis-ltr-dev\include;D:\OSGeo4W\apps\Qt5\include;D:\OSGeo4W\apps\Qt5\include\QtCore;D:\OSGeo4W\apps\Qt5\include\QtGui;D:\OSGeo4W\apps\Qt5\include\QtWidgets;D:\OSGeo4W\apps\Qt5\include\QtXml
这部分要参考你自己的路径
附加库目录（.lib 文件路径）
进入“链接器” → “常规” → “附加库目录”，添加：
text
D:\OSGeo4W\apps\qgis-ltr-dev\lib;D:\OSGeo4W\apps\Qt5\lib
附加依赖项（需要链接的库）
进入“链接器” → “输入” → “附加依赖项”，添加以下一行（如果已有其他内容，用分号追加在后面）：
qgis_core.lib;qgis_gui.lib;qgis_analysis.lib;Qt5Core.lib;Qt5Gui.lib;Qt5Widgets.lib;Qt5Xml.lib
预处理器定义
进入“C/C++” → “预处理器” → “预处理器定义”，添加（在原本基础上）：
_USE_MATH_DEFINES;NOMINMAX;_SILENCE_STDEXT_ARR_ITERS_DEPRECATION_WARNING
C++ 语言标准
进入“C/C++” → “语言” → “C++语言标准”，选择“ISO C++17 标准 (/std:c++17)”。
所有环境搭建完成。
#include <QApplication>
#include <QMainWindow>
#include <QMessageBox>
#include <qgsapplication.h>
#include <qgsmapcanvas.h>
#include <qgsrasterlayer.h>
#include <qgsproject.h>
#include <qgsmaptoolpan.h>
#include <QDebug>
int main(int argc, char *argv[])
{
// 初始化 QGIS 应用
QgsApplication app(argc, argv, true);
QgsApplication::setPrefixPath("D:/OSGeo4W/apps/qgis-ltr", true);
app.initQgis();
// 创建主窗口
QMainWindow window;
window.setWindowTitle(QString::fromLocal8Bit("QGIS 加载 TIFF 测试"));
// 创建地图画布
QgsMapCanvas *canvas = new QgsMapCanvas();
canvas->setCanvasColor(Qt::white);
window.setCentralWidget(canvas);
// 你的 TIFF 文件路径（请根据实际情况修改）
QString tiffPath = QString::fromLocal8Bit("D:/tiff_picture/SR_50M_alaska_nad.tif");
// 创建栅格图层
QgsRasterLayer *layer = new QgsRasterLayer(tiffPath, QString::fromLocal8Bit("阿拉斯加影像"), "gdal");
if (!layer->isValid())
{
QMessageBox::critical(nullptr,
QString::fromLocal8Bit("错误"),
QString::fromLocal8Bit("无法加载 TIFF 文件：\n%1").arg(tiffPath));
qDebug() << "图层加载失败！";
delete layer;
return 1;
}
// 添加图层到项目和画布
QgsProject::instance()->addMapLayer(layer);
canvas->setLayers({layer});
canvas->setExtent(layer->extent());
canvas->refresh();
// 添加平移工具
QgsMapToolPan *panTool = new QgsMapToolPan(canvas);
canvas->setMapTool(panTool);
// 显示窗口
window.show();
// 进入事件循环
int ret = app.exec();
// 清理
app.exitQgis();
return ret;
}
这是我的测试代码
VS打开Qt的ui界面几秒后闪退（ui无法打开文件）的解决办法
VS打开Qt的ui界面几秒后闪退（ui无法打开文件）的解决办法_vs打开ui文件闪退-CSDN博客