1. QGIS与Qt开发环境搭建概述
作为一名长期从事地理信息系统开发的工程师,我深知环境配置是新手入门QGIS二次开发的第一道门槛。很多初学者在Windows平台下使用Visual Studio进行Qt和QGIS开发时,常常被各种环境变量、依赖库和编译选项搞得晕头转向。本文将分享一套经过实战验证的"傻瓜式"搭建方案,帮助开发者快速构建稳定的开发环境。
QGIS作为开源GIS软件的标杆,其二次开发主要基于Qt框架和C++语言。在Windows平台下,Visual Studio提供了强大的代码编辑和调试能力,是理想的开发环境选择。但三者的集成需要特别注意版本兼容性:QGIS 3.x系列需要Qt 5.x版本支持,而Visual Studio的编译器版本也需要与Qt的预编译版本匹配。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与工具下载
2.1 软件版本选择建议
根据我的项目经验,推荐以下版本组合:
- Visual Studio 2019 Community Edition(版本16.11)
- Qt 5.15.2(MSVC 2019 64-bit)
- QGIS 3.28.0(LTR版本)
- CMake 3.25+
这个组合经过多个实际项目验证,具有最好的稳定性和兼容性。特别提醒:Qt 5.15是最后一个提供离线安装包的LTS版本,后续版本需要通过在线安装器获取。
2.2 安装顺序与关键步骤
-
Visual Studio安装:
- 安装时务必勾选"使用C++的桌面开发"工作负载
- 额外勾选Windows 10 SDK(版本19041)
- 安装后验证cl.exe编译器能否在命令行中调用
-
Qt安装:
- 下载官方在线安装器(qt-unified-windows-x64-4.5.1-online.exe)
- 选择安装Qt 5.15.2组件时,必须勾选:
- MSVC 2019 64-bit
- Qt Charts
- Qt WebEngine
- 设置Qt环境变量(后续会详细说明)
-
QGIS SDK安装:
- 从官网下载QGIS SDK包(qgis-dev-3.28.0-20221120.tar.bz2)
- 解压到不含中文和空格
