VS2015环境下GDAL3.1.2与PROJ6的联合编译实战指南

原创

于 2026-02-27 10:19:42 发布 · 505 阅读

1. 环境准备与依赖关系梳理

大家好，我是老张，一个在地理信息行业摸爬滚打了十多年的老码农。今天咱们不聊虚的，直接上干货，手把手带你搞定在Windows 10系统下，用Visual Studio 2015（简称VS2015）编译GDAL 3.1.2这个“硬骨头”。很多朋友一听到编译开源库就头疼，尤其是GDAL这种依赖关系复杂的，动不动就报错，确实让人抓狂。我当年也是被各种“找不到头文件”、“链接库错误”折磨得够呛，所以这次我把踩过的坑、趟过的路都总结出来，争取让你一次成功。

首先，咱们得搞清楚GDAL 3.x版本和之前版本最大的不同点：它对PROJ库的依赖发生了根本性变化。GDAL 3.0是个分水岭，从这个版本开始，它强制依赖PROJ 6.0或更高版本。而PROJ 6本身也进行了架构重构，其核心的空间参考和坐标转换数据不再像老版本PROJ.4那样散落在多个文件里，而是集中存储在一个名为proj.db的SQLite数据库文件中。这就引出了一个连锁反应：要编译PROJ 6，你得先有SQLite3环境。所以，咱们的编译链条就变成了：SQLite3 -> PROJ 6 -> GDAL 3.1.2。这个顺序绝对不能错，就像盖房子，得先打地基再砌墙。

工欲善其事，必先利其器。在开始下载源码之前，请确保你的电脑上已经安装好了以下工具：

Visual Studio 2015：这是我们的主力编译器。请务必安装“Visual C++”相关组件。安装完成后，你可以在开始菜单里找到“VS2015 x64 本机工具命令提示符”，后续的编译命令我们都在这个命令行环境下执行，它能确保所有的环境变量（特别是编译器、链接器路径）都设置正确。
CMake：PROJ和很多现代开源库一样，使用CMake作为跨平台的构建系统生成器。我们需要用它来生成VS2015能识别的解决方案（.sln）和项目文件。去CMake官网下载最新版的Windows安装包（比如3.18.3或更高），选择.msi格式安装最省事。安装时记得勾选“Add CMake to the system PATH for all users”，这样在命令行里就能直接用了。
7-Zip或类似工具：用于解压下载的源码压缩包。

准备好这些，咱们就可以开始第一步，也是最基础的一步：搞定SQLite3。别看它只是个轻量级数据库，在这里可是PROJ的“数据心脏”，必须稳当。

2. 编译SQLite3静态库

为什么非要自己编译SQLite3？直接从官网下载预编译的DLL不行吗？理论上可以，但实践中很容易出问题。PROJ在通过CMake配置时，会去寻找SQLite3的开发文件（即.lib静态库和.h头文件），以确保能正确链接。使用我们自己编译的静态库，可以保证编译选项的兼容性，避免后续PROJ和GDAL链接时出现莫名其妙的运行时错误。这一步虽然有点绕，但却是保证整个流程顺畅的关键。

首先，我们去SQLite官网的下载页面。找到“Source Code”部分，下载sqlite-amalgamation-xxxxxxx.zip这个文件。所谓“Amalgamation”，就是把所有C源码文件合并成一个sqlite3.c和一个sqlite3.h，这样编译起来特别方便，特别适合我们这种集成到其他项目中的场景。我这次用的是3.33.0版本，你下载时版本号可能更高，但操作完全一样。同时，为了后续测试方便，我们也在“Precompiled Binaries for Windows”下，下载64位的DLL和命令行工具包，分别是sqlite-dll-win64-x64-xxxxxxx.zip和sqlite-tools-win32-x86-xxxxxxx.zip。

下载完成后，我习惯在D盘根目录（你也可以选其他位置，但路径里最好不要有中文和空格）创建一个sqlite-3.33.0文件夹，把三个压缩包都解压进去。解压后的目录结构看起来有点乱，我们需要整理一下。核心的源码文件在sqlite-amalgamation-3330000文件夹里，我们需要的是sqlite3.c、sqlite3.h和sqlite3ext.h。从sqlite-dll-win64-x64-3330000</

标签