1. 环境准备与工具安装在Windows 11系统上使用VS2022编译GDAL 3.7.1之前需要先搭建完整的开发环境。我建议先准备一个至少50GB可用空间的磁盘分区因为编译过程中会产生大量中间文件。实测在C盘操作时曾因空间不足导致编译失败。必备工具清单Visual Studio 2022社区版即可CMake 3.26.3或更高版本Git for Windows用于源码管理7-Zip解压源码包安装VS2022时务必勾选使用C的桌面开发工作负载特别要确保勾选Windows 10/11 SDKC CMake工具英文语言包避免中文路径问题我遇到过因为没装英文语言包导致CMake路径解析失败的情况。安装完成后建议在PowerShell中运行cl命令验证环境变量是否配置正确。如果报错可能需要以管理员身份运行VS2022安装目录下的vcvarsall.bat。2. 依赖库编译实战2.1 SQLite3编译详解从官网下载sqlite-amalgamation-3420000.zip源码包后解压到D:\DevLibs\sqlite3目录。这里有个坑不要使用包含autoconf的版本那个是为Linux准备的。打开VS2022的x64 Native Tools Command Prompt依次执行cd D:\DevLibs\sqlite3 cl /c /O2 /I. shell.c sqlite3.c link /out:sqlite3.dll /DLL sqlite3.obj /DEF:sqlite3.def编译完成后会生成三个关键文件sqlite3.dll动态库sqlite3.lib导入库sqlite3.exp导出文件建议将这三个文件复制到D:\DevLibs\sqlite3\dist目录备用。我曾因为直接使用编译目录导致后续CMake配置混乱。2.2 TIFF库编译技巧从ftp下载tiff-4.5.0.tar.gz后用CMake-GUI配置时要注意勾选BUILD_SHARED_LIBS生成动态库设置CMAKE_INSTALL_PREFIX为D:\DevLibs\tiff添加SQLite3_DIR指向之前编译的sqlite3目录点击Generate生成VS工程后在解决方案资源管理器中右键ALL_BUILD → 生成右键INSTALL → 生成成功后会看到D:\DevLibs\tiff目录下出现完整的include/lib/bin结构。特别注意如果遇到LNK2001错误可能是没正确链接zlib库。2.3 PROJ9.2编译避坑指南PROJ的编译最易出错关键步骤从GitHub下载proj-9.2.0.tar.gzCMake配置时开启ENABLE_TIFFON设置SQLite3_INCLUDE_DIR和SQLite3_LIBRARY添加TIFF_INCLUDE_DIR和TIFF_LIBRARY_RELEASE编译过程中可能遇到C4996警告在项目属性 → C/C → 高级中设置禁用特定警告为4996LNK2038不匹配检查运行时库是否一致MD/MDd3. GDAL主库编译全流程3.1 CMake关键配置在gdal-3.7.1目录旁新建build目录CMake-GUI中设置Source: D:/DevLibs/gdal-3.7.1 Build: D:/DevLibs/gdal-3.7.1/build点击Configure后需要手动设置PROJ_INCLUDE_DIR D:/DevLibs/proj/includePROJ_LIBRARY_RELEASE D:/DevLibs/proj/lib/proj.libTIFF_INCLUDE_DIR D:/DevLibs/tiff/includeTIFF_LIBRARY_RELEASE D:/DevLibs/tiff/lib/tiff.lib3.2 VS2022编译优化生成解决方案后在VS2022中打开GDAL.sln。建议进行以下调整右键gdal项目 → 属性 → C/C → 代码生成 → 启用增强指令集AVX2链接器 → 优化 → 引用是 (/OPT:REF)关闭调试信息生成Release配置编译时选择Release x64配置先生成ALL_BUILD再生成INSTALL。整个过程约15-30分钟取决于CPU性能。我在i7-12700H上耗时18分钟。4. 项目集成与测试4.1 环境变量配置需要添加以下系统变量PATH D:\DevLibs\gdal\bin;D:\DevLibs\proj\bin;D:\DevLibs\tiff\bin GDAL_DATA D:\DevLibs\gdal\share\gdal PROJ_LIB D:\DevLibs\proj\share\proj验证配置是否成功gdalinfo --version应输出GDAL 3.7.1, released 2023-xx-xx4.2 VS2022项目设置新建C控制台项目后配置项目属性VC目录 → 包含目录D:\DevLibs\gdal\includeD:\DevLibs\proj\includeD:\DevLibs\tiff\include链接器 → 附加库目录D:\DevLibs\gdal\libD:\DevLibs\proj\libD:\DevLibs\tiff\lib附加依赖项gdal.libproj.libtiff.lib4.3 测试代码实战使用以下代码测试栅格读取功能#include gdal_priv.h #include iostream int main() { GDALAllRegister(); GDALDataset* ds (GDALDataset*)GDALOpen(test.tif, GA_ReadOnly); if(ds) { int width ds-GetRasterXSize(); int height ds-GetRasterYSize(); std::cout 图像尺寸: width x height std::endl; GDALClose(ds); } else { std::cerr 文件打开失败: CPLGetLastErrorMsg() std::endl; } return 0; }如果遇到无法打开GDAL库错误检查所有DLL是否在PATH包含的目录中项目平台是否与库一致x64运行时库设置是否匹配MD/MDd5. 常见问题解决方案5.1 编译错误排查错误1CMake找不到SQLite3解决方法手动指定SQLite3_INCLUDE_DIR和SQLite3_LIBRARY错误2LNK2019未解析符号可能原因PROJ版本不匹配确保使用9.2.0版本错误3运行时崩溃检查点所有依赖DLL的版本一致性建议用Dependency Walker工具检查5.2 性能优化建议启用OpenCL加速 在CMake中开启GDAL_ENABLE_OPENCL使用多线程编译 在VS2022中设置项目 → 属性 → C/C → 多处理器编译裁剪不需要的驱动 在gdal/nmake.opt中注释掉DRIVERS不需要的项6. 进阶配置技巧6.1 自定义驱动开发要开发自定义GDAL驱动需要在编译时在gdal/frmts目录下新建驱动文件夹修改CMakeLists.txt添加新目录实现GDALDriver接口类6.2 Python绑定编译如需Python支持pip install numpy set PYTHONPATHD:\DevLibs\gdal\swig\python cd gdal/swig/python python setup.py build_ext --include-dirsD:\DevLibs\gdal\include6.3 交叉编译说明虽然本文聚焦Windows平台但相同方法稍作修改也可用于使用WSL2编译Linux版本通过MinGW编译32位版本交叉编译Android版本关键是要调整CMake的toolchain文件指定不同的编译器路径。我在移植到ARM平台时最大的坑是PROJ的SIMD指令集兼容性问题。