VS2010下编译libcurl 7.71.1的完整指南

简介面向需要在Visual Studio 2010同时兼容VS2008环境中快速集成libcurl的C开发者这份资源可直接绕过源码编译的繁琐配置重点解决了Release模式下常见的外部链接错误附带说明也给出了排查思路。压缩包共13个文件包含10个curl核心头文件、2个debug/release版本的静态库文件以及1份编译使用说明整体体积仅287KB轻量易用。库本身支持HTTP、HTTPS、FTP、SMTP等主流网络协议覆盖TLS加密、Cookie、代理、重定向等常用功能适合需要快速实现网络传输能力的桌面应用或工具项目。已有280人下载学习对于希望规避环境配置雷区、直接获得可编译库文件的开发者而言是一份节省时间且实用性强的资源。1. 为什么还在VS2010上跟libcurl较劲1.1 生产环境里的历史包袱VS2010这台“老爷级”编译器在很多团队里其实一直没有退役不是不想升级而是根本升不动。工控上位机、设备通讯服务、一些只维护不迭代的老系统都还非常依赖这套工具链。一旦项目里冒出来联网需求想让libcurl在VS2010下编译出一个可用的库就成了绕不过去的活。真正动手的时候你会发现直接拿最新版libcurl是不行的。新版代码对编译器特性的要求抬得越来越高特别是C99特性的依赖越来越多而VS2010的C编译器对C99的支持并不完整强行编会冒出一堆莫名其妙的语法错误。我实测下来libcurl 7.71.1算是VS2010能顺畅编译的版本区间里功能较新的一版再往后走兼容性就开始挣扎了。这篇我把整个流程重新走一遍源码准备、工程生成、编译选项、集成部署、问题排查给同样被老环境困住的人一条能直接照抄的路。1.2 libcurl版本选型7.71.1是VS2010的友好版本选版本的第一原则是够用且能编。libcurl 7.71.1发布于2020年支持HTTP/2通过第三方库介入、TLS 1.3取决于TLS后端更重要的是它自带的源码包里保留了从VC6到VC15的完整工程文件。这一步非常关键——官方至今还在维护这些老VC工程说明连curl自己都承认老工具链仍有使用场景。这个版本再往上走源码里一些函数实现开始引入对较新编译器的假设7.80.x之后在VS2010上编译失败的概率明显增加。那为什么不干脆退回更早的版本呢如果项目要求不高7.40.0、7.50.0也能编但老版本对TLS 1.2的新特性支持不完善很多服务端已经禁用了旧加密套件老curl连上去直接握手失败。所以7.71.1卡在“新特性”和“编译器兼容”之间位置比较准这也是很多人最终停在这个版本的主要原因。2. 编译前准备把VS2010环境整利索2.1 VS2010 SP1和Win10兼容性处理编译之前先确认VS2010已经升级到SP1。有些机器上装的还是原始版连编译64位目标都会卡壳。SP1对应的补丁包编号是KB983509安装包体积不小安装时间也比较长而且必须用管理员权限装。装完之后在“关于”对话框里能看到Service Pack 1才算到位。如果你是在Win10上跑VS2010最典型的麻烦是安装程序无法正常启动或者编译时资源编辑器崩溃。我的处理办法是右键整个VS2010安装目录和快捷方式以管理员身份运行并手动把兼容模式改成Windows 7。另一个Win10上的经典问题是系统自带的Windows SDK版本比7.1高而VS2010默认去寻Windows SDK 7.1一旦找不到就会整出各种路径错误。这时候要去“工具→选项→项目和解决方案→VC目录”里手工核对并添加SDK的包含路径和库路径或者干脆装一个Windows SDK 7.1把环境变量一次整干净。编译libcurl这种底层库环境不干净会出现很多看起来毫不相关的报错这一节值得多花几分钟。2.2 拉取libcurl 7.71.1源码源码建议从curl官网下载页拿文件名是curl-7.71.1.tar.xz。Windows下解压tar.xz有点折腾我一般直接去GitHub上找tag为curl-7_71_1的zip包下载和解压都方便。解压后的目录结构大致是这样curl-7.71.1/ ├─ projects/ │ ├─ Windows/ │ │ ├─ vc10/ │ │ └─ generate.bat ├─ include/curl/ ├─ lib/ ├─ src/ └─ CMakeLists.txt源码体积不大解压完大概几十MB编译产物还会额外占一点空间。如果电脑上装了Git也可以git clone后切到对应tag保证拿到的代码和这篇文章一致。注意不要直接clone master分支新版代码已经不适合VS2010别给自己找麻烦。2.3 决定SSL方案用SChannel绕开OpenSSL大坑libcurl要访问HTTPS必须有TLS后端。在VS2010这个环境里最省心的方案不是OpenSSL而是Windows系统自带的SChannel。选OpenSSL不是不行但你得先在VS2010里把整套OpenSSL库编出来过程需要Perl、NASM、配置半天整套流程足够让人怀疑人生。SChannel是Windows内置的TLS实现libcurl编译时只要启用USE_SCHANNEL这个预处理宏运行时会直接调用系统TLS能力证书也从系统证书库取省去证书文件管理的麻烦在Windows上本来就是正统做法。什么情况下才必须用OpenSSL如果你要用的加密套件SChannel不支持或者要跨平台部署并保持各个平台行为一致才需要去啃OpenSSL。对于大多数Windows老项目SChannel完全够用。3. 动手编译两条路径实测对比3.1 官方VC10工程generate.bat一键生成最省事的路径是用libcurl自带的生成脚本。打开一个管理员权限的命令行窗口定位到源码的projects目录执行generate.bat vc10这个脚本会扫描本机的依赖项比如有没有安装OpenSSL、Windows SDK在哪个位置然后在projects/Windows/vc10目录下生成对应的.sln和.vcxproj文件。如果你只需要一个能跑的版本生成的解决方案里重点关注三个工程libcurl静态库、libcurl动态库、curl命令行工具。接着用VS2010打开projects/Windows/vc10/curl-all.sln把解决方案配置切到Release然后在配置下拉菜单里选“LIB Release - DLL Windows SSPI”这一类选项。命名逻辑是LIB代表静态库DLL代表动态库Windows SSPI表示使用Windows自带的TLS也就是SChannel。没有特殊需求的话我推荐生产环境直接选“LIB Release - DLL Windows SSPI”原因后面再说。右键生成libcurl项目编译几十个.c文件一两分钟就能完成产物会输出到源码根目录附近的build文件夹里。这里有个容易踩的坑generate.bat只负责生成工程不会把依赖链全部搞定。如果你勾选了带OpenSSL的配置而机器上并没有对应的依赖目录编译时会冒出一堆找不到头文件的错误。所以要么先把依赖就位要么就老老实实用不带OpenSSL的配置别两头都想要最后两头都编不过。3.2 CMake生成适合定制化需求的备选如果觉得官方工程里的配置项不够灵活或者要把libcurl集成到更复杂的CMake项目里CMake是另一条路。在VS2010下建议用CMake 3.16到3.20这个区间太新的CMake对旧版Visual Studio生成器的支持正在逐步收窄太老又可能不支持7.71.1源码里的某些CMakeLists语法。假设我已经在源码根目录下建好了build-vs2010子目录命令行执行cmake -G Visual Studio 10 2010 ^ -DCMAKE_USE_OPENSSLOFF ^ -DCMAKE_USE_WINSSLON ^ -DBUILD_SHARED_LIBSON ^ -DCMAKE_INSTALL_PREFIXC:\libcurl-install ^ ..参数含义很直白-G指定生成VS2010工程CMAKE_USE_OPENSSLOFF表示不用OpenSSLCMAKE_USE_WINSSLON表示启用Windows的SChannelBUILD_SHARED_LIBS决定构建动态库还是静态库CMAKE_INSTALL_PREFIX是后面执行install时的输出目录。生成完成后打开build-vs2010/curl.sln在VS2010里编译libcurl和curl工程即可。CMake的好处是改选项直观坏处是生成的解决方案里会多出一堆工具项目编译时间略长而且CMake版本不合适的时候会生成VS2010打不开的vcxproj格式这个坑我在问题清单里会单列。如果只是为了快速拿到库用官方VC10工程更稳。3.3 两种方式怎么选我的建议很明确能用官方VC10就不用CMake。原因很简单libcurl官方对老VC环境的兼容性一直在维护generate.bat本身就是最了解这份源码该怎么编的程序。CMake更多是为了自动化持续集成、跨平台一套脚本打天下的场景准备的。如果你只是本地编一次库然后丢给项目用没必要绕弯子去折腾CMake。4. 编译产物接入让新项目快速用上libcurl4.1 整理头文件和库文件编译完成后拿到的核心文件是.lib和.dll。官方VC10工程输出的文件名根据配置有差异静态库可能叫libcurl.lib动态库可能叫libcurl.dll配合一个导入库libcurl.lib光看名字容易混我的习惯是用目录把形态分开。third_party/ ├─ include/curl/*.h └─ lib/ ├─ static/libcurl.lib └─ dll/libcurl.lib libcurl.dll头文件直接复制源码里include/curl这个目录一共十几个.h文件全部一起拷走。只要拿到include和lib这两个目录源码包就可以收起来了后续项目构建不需要再解压一遍源码。建议再写一个README放在third_party下面记录编译时选的配置、工具链版本和日期不然过几个月自己都分不清这份静态库到底带不带SSL。4.2 项目配置里的三个关键点在VS2010的使用方工程里配置libcurl需要动三个位置。第一C/C→常规→附加包含目录加上third_party/include第二链接器→常规→附加库目录根据选的是静态库还是动态库指向对应子目录第三链接器→输入→附加依赖项填上libcurl.lib还有一串系统库。最容易被忽略的就是后面那些系统依赖库不加的话链接阶段会抛一堆Winsock相关错误libcurl.lib : error LNK2019: unresolved external symbol __imp_Ws2_32...把ws2_32.lib、wldap32.lib、crypt32.lib和libcurl.lib一起填进去。即使暂时用不到SSL加crypt32.lib也没副作用省得以后换配置又忘了补。另一个关键点是宏定义。用静态库使用者工程预处理器里必须定义CURL_STATICLIB用动态库则不能定义。这个宏直接决定头文件里的函数声明走__declspec(dllimport)还是本地符号查找搞反了会出现莫名其妙的链接失败而且这类错误往往跟真正的代码逻辑没有半点关系排查起来非常耗时间。4.3 一段能跑的HTTPS请求Demo配置完成后写段代码验证最直接。下面的例子发起一个GET请求把返回内容写进文件覆盖了写回调、初始化、清理三个基础环节。#include stdio.h #include curl/curl.h static size_t write_cb(char *ptr, size_t size, size_t nmemb, void *userdata) { FILE *fp (FILE *)userdata; return fwrite(ptr, size, nmemb, fp); } int main(void) { CURL *curl NULL; CURLcode res; curl_global_init(CURL_GLOBAL_DEFAULT); curl curl_easy_init(); if (curl) { FILE *fp fopen(response.bin, wb); if (fp) { curl_easy_setopt(curl, CURLOPT_URL, https://example.com); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_cb); curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp); curl_easy_setopt(curl, CURLOPT_TIMEOUT, 30L); res curl_easy_perform(curl); fclose(fp); if (res ! CURLE_OK) { fprintf(stderr, curl error: %s\n, curl_easy_strerror(res)); } } curl_easy_cleanup(curl); } curl_global_cleanup(); return 0; }编译运行后如果程序正常退出response.bin里能看到网页内容就说明库已经正确接入了。回调函数写成static是为了避免符号冲突这个细节在一些大型项目里很实用。5. 编译与使用中的5个高频坑5.1 __imp_Ws2_32链接错误这个错误出现频率最高。现象是链接最后阶段抛出一串unresolved external symbol函数名带__imp_前缀典型的Windows系统库缺失。解决办法就是往附加依赖项里逐个补ws2_32.lib、wldap32.lib用了SSL后端再加crypt32.lib。链接错误信息其实已经把答案写出来了哪个符号找不到就查这个符号属于哪个系统库比直接百度错误码高效得多。5.2 C4996警告被当成错误VS2010对fopen、strcpy这类CRT函数会给出弃用警告默认只是警告但很多项目开了/WX严格模式警告会被直接升级成错误。这种情况最常见的出现位置是的使用方Demo代码而不是libcurl自身源码。解决方式是在预处理器定义里加_CRT_SECURE_NO_WARNINGS一劳永逸。如果你在项目里有大量旧式字符串函数这个宏几乎可以杜绝所有相关编译中断。5.3 HTTPS请求直接失败如果libcurl编出来了程序也能启动但一访问HTTPS就报CURLE_SSL_CONNECT_ERROR或CURLE_PEER_FAILED_VERIFICATION大多数情况是TLS后端跟代码预期不一致。比如你实际编的是不带SSL的HTTP_ONLY版本代码却请求了https链接或者用的是OpenSSL后端证书路径又没配置。换成SChannel方案后证书来自系统基本不会再出现根证书找不到的问题。还有一类隐蔽情况VS2010编译的代码如果漏掉curl_global_initTLS初始化不会自动发生后面的SSL请求就会以奇怪的方式失败。我自己的项目里就踩过这个坑最后发现是全局初始化没调用。5.4 Win10上找不到Windows SDK 7.1VS2010在Win10上打开老工程经常报“由于计算机缺少Windows SDK 7.1无法生成此项目”。处理思路有两条一是安装Microsoft Windows SDK for Windows 7安装包比较老需要用兼容模式跑二是修改工程的Windows SDK Version属性指向本机已有的SDK版本。对于libcurl的VC10工程后者更省事。用VS2010打开curl-all.sln时如果弹出SDK提示直接点取消然后逐个工程检查“配置属性→常规→Windows SDK Version”改成8.1或本机可用的版本。头文件里引用的windows.h版本差异不大一般都能编过。5.5 静态库与动态库宏定义混用这算最隐蔽的坑。静态库的libcurl.lib配合使用方工程里的CURL_STATICLIB宏动态库则需要完全不定义这个宏。如果你在同一台机器上同时维护两个项目一个用静态库一个用动态库而预处理器定义是复制粘贴来的链接阶段就会出现千奇百怪的报错甚至干脆进不去curl初始化。我的习惯是给third_party目录里的每个lib形态单独建子目录并在README里写清楚对应宏的要求避免过几个月自己都记不清。项目里也只有一种库形态不要混着用。说实话VS2010和libcurl 7.71.1这个组合像两台老机器互相咬合只要第一个齿轮转对了后面就顺了。我自己在工控机项目上长期跑这套组合做数据上报稳定性一直不错。如果公司里还有老环境升不了级希望这篇能帮你少走弯路。最后提醒一句编译前把依赖补齐编译时看清静态还是动态编译完先跑一个带回调的HTTPS请求验证确认没问题再把库交到项目手里后面就踏实了。本文还有配套的精品资源点击获取