简介本资源是为Windows 10平台开发者提供的、基于Visual Studio 2019预编译完成的64位cURL静态/动态链接库版本7.84.0当前稳定最新版完整支持HTTPS协议及SSL/TLS加密通信适用于C/C网络编程、HTTP客户端开发、自动化脚本集成等场景尤其适合刚接触网络库编译或希望跳过复杂构建流程的中初级开发者。压缩包共19个文件包含头文件.h、导入库.lib、导出符号文件.exp、运行时DLL、可执行程序curl.exe及构建说明文档README.md结构已按标准lib/include目录组织开箱即用。资源体积仅354KB轻量紧凑便于嵌入项目或快速验证。目前已有774人学习下载附带的curl.exe可直接用于命令行HTTP调试配合头文件与库文件能立即开展GET/POST/上传下载等全功能开发实践显著降低环境搭建门槛。1. 项目概述与背景在Windows平台上进行C/C开发尤其是涉及到网络通信、文件传输或API调用时一个稳定可靠的HTTP客户端库几乎是不可或缺的基础设施。Curl这个由Daniel Stenberg创建的开源项目凭借其强大的协议支持HTTP/HTTPS、FTP、SMTP等、高度的可移植性和活跃的社区成为了无数开发者的首选。然而对于Windows开发者特别是使用Visual Studio生态的开发者来说直接使用Curl官方提供的预编译二进制包有时并不能完全满足需求。比如你可能需要链接到特定的运行时库MT/MTd vs MD/MDd或者需要针对特定的OpenSSL版本进行编译又或者官方提供的版本与你项目所使用的Visual Studio版本不匹配导致链接错误或运行时崩溃。这正是我决定在Windows 10环境下使用Visual Studio 2019手动编译64位Curl库版本7.84.0的初衷。7.84.0是一个相对稳定且功能完善的版本修复了之前版本的一些安全问题同时API也保持稳定。自己动手编译意味着你可以完全掌控构建过程选择所需的第三方依赖如OpenSSL、zlib、配置编译选项如是否启用SSL、IPv6、HTTP/2、以及生成适用于你项目配置Debug/Release 动态库/静态库的二进制文件。这个过程虽然有些繁琐但一旦完成你将获得一个与你的开发环境完美契合的“定制化”工具库后续的集成和调试都会顺畅许多。这篇文章就是记录我从环境准备、依赖配置、编译构建到最终测试的完整过程以及其中踩过的坑和总结的经验希望能为有同样需求的开发者提供一份清晰的“避坑指南”。2. 编译环境与工具链准备工欲善其事必先利其器。在开始编译Curl之前确保你的开发环境是正确且完整的这是避免后续一系列诡异错误的第一步。2.1 操作系统与Visual Studio 2019我的基础环境是Windows 10 专业版 64位版本号最好是比较新的比如20H2或更高以确保系统组件和SDK的完整性。核心工具是Visual Studio 2019 Community/Professional/Enterprise版本。我使用的是VS2019专业版但社区版完全足够。关键在于安装时必须勾选“使用C的桌面开发”工作负载。注意仅仅安装VS2019是不够的必须确保包含了对应的Windows SDK和MSVC工具集。在VS安装程序的“单个组件”选项卡中搜索并确认安装了与你VS2019版本匹配的“Windows 10 SDK”和“MSVC v142 - VS 2019 C x64/x86 生成工具”。我推荐使用Windows 10 SDK (10.0.19041.0) 或更高版本。安装完成后为了能在命令行中直接使用cl、nmake等编译工具你需要打开“适用于VS 2019的 x64 本机工具命令提示符”。这个快捷方式位于开始菜单的Visual Studio 2019文件夹下。它会自动设置好所有必要的环境变量如INCLUDE、LIB、PATH这是后续使用nmake编译的关键。千万不要使用普通的CMD或PowerShell否则会找不到编译器。2.2 Curl源码与Perl环境接下来是获取源码。前往Curl的官方GitHub发布页面找到版本7.84.0的源代码压缩包通常是curl-7.84.0.tar.gz。下载后解压到一个没有中文和空格的路径下例如D:\Dev\curl-7.84.0。这就是我们的工作目录。Curl在Windows下的构建系统依赖于一个古老的但至关重要的工具Perl。这是因为其构建配置文件Makefile.vc需要Perl来进行预处理。你需要安装一个Windows版本的Perl。我推荐使用Strawberry Perl因为它自带了许多有用的工具并且安装简单。从官网下载安装程序一路下一步即可。安装后同样需要确保Perl的可执行文件路径例如C:\Strawberry\perl\bin被添加到了系统的PATH环境变量中或者在VS命令提示符下该路径是可见的。你可以在VS命令提示符中输入perl -v来验证是否安装成功。2.3 第三方依赖库OpenSSL与zlibCurl的强大功能离不开其第三方依赖。对于最基本的HTTPS支持我们需要OpenSSL库。在Windows下编译OpenSSL本身又是一个大工程为了简化我强烈建议直接使用预编译好的二进制包。Shining Light Productions 网站提供了非常完善的Windows预编译OpenSSL库我们选择与VS2019匹配的版本。下载OpenSSL访问相关资源站下载适用于Visual Studio 2019的64位版本。例如选择Win64 OpenSSL v1.1.1x Light或Win64 OpenSSL v3.0.x Light。Light版本只包含库文件足够我们使用。我选择的是OpenSSL 1.1.1s因为它非常稳定且兼容性广。下载的是一个安装程序运行它并安装到一个简单路径比如D:\Dev\OpenSSL-Win64。下载zlibzlib用于压缩解压缩很多HTTP传输会用到。同样我们可以使用预编译版本。从zlib官网或相关资源站下载zlib compiled DLL。我使用的是zlib 1.2.13的预编译包。解压后你会得到zlib.lib、zlib.dll和头文件。现在你的依赖库目录结构应该类似这样D:\Dev\ ├── curl-7.84.0\ (Curl源码) ├── OpenSSL-Win64\ (OpenSSL包含lib, include, bin目录) └── zlib-1.2.13\ (zlib包含 lib, include, dll 文件)3. 编译配置与参数详解准备好所有材料后我们就可以开始“烹饪”了。编译的核心在于一个叫Makefile.vc的文件我们需要用Perl来生成针对我们环境的特定Makefile。3.1 生成定制的Makefile首先用之前提到的“x64本机工具命令提示符”导航到Curl源码目录cd D:\Dev\curl-7.84.0\winbuildwinbuild目录是专门为Windows的NMake构建准备的。接下来使用nmake命令配合Makefile.vc来构建。但直接运行前我们需要通过参数告诉它我们的配置。一个最基础的、支持SSL的静态库编译命令如下nmake /f Makefile.vc modestatic VC19 MACHINEx64 DEBUGno WITH_SSLstatic WITH_ZLIBstatic SSL_PATHD:\Dev\OpenSSL-Win64 ZLIB_PATHD:\Dev\zlib-1.2.13让我详细解释一下每个参数的含义这是理解整个构建过程的关键nmake /f Makefile.vc: 指定使用NMake工具并采用Makefile.vc这个模板文件。modestatic: 这是我们生成库的类型。static表示生成静态库.lib文件你的程序在链接时会将这些代码直接打包进你的exe。另一个选项是dll生成动态链接库.dll和.lib。选择建议如果你希望分发程序时不需要附带额外的DLL文件或者避免DLL版本冲突就用static。但这样会导致你的可执行文件体积变大。如果多个模块都要用curl用dll可以节省空间。VC19: 这指定了Visual Studio的版本号。VS2019对应的是16但这里用的是编译器工具集版本v142的内部代号19。这是一个关键点必须正确。VS2017是15VS2022是17。MACHINEx64: 目标平台是64位。如果需要32位库则使用x86。DEBUGno: 生成Release版本的库优化级别高不带调试信息。如果需要调试则设为yes会生成带调试信息的.pdb文件和未优化的代码。WITH_SSLstatic: 指定使用OpenSSL并且以静态链接的方式链接到Curl库中。这意味着OpenSSL的代码也会被整合进最终的libcurl.lib里。如果这里用dll则需要运行时提供libssl-1_1-x64.dll等文件。重要选择static还是dll必须和你的OpenSSL库本身类型匹配。我们下载的预编译OpenSSL通常同时提供了静态库.lib和动态库.dll.lib。如果你指定WITH_SSLstatic那么nmake会去寻找libssl.lib和libcrypto.lib静态库。如果你指定WITH_SSLdll它会去寻找libssl.lib和libcrypto.lib动态库的导入库以及对应的DLL。WITH_ZLIBstatic: 类似地指定使用zlib并静态链接。SSL_PATHD:\Dev\OpenSSL-Win64:这是最容易出错的地方之一。这个路径必须指向你的OpenSSL安装的根目录在这个目录下nmake期望找到include子目录包含头文件和lib子目录包含库文件。预编译的OpenSSL安装后通常符合这个结构。ZLIB_PATHD:\Dev\zlib-1.2.13: 同理指向zlib的根目录需要包含include和lib子目录。3.2 高级配置选项与常见组合除了上述基本参数Makefile.vc还支持很多其他选项让你可以精细控制Curl的功能。RTLIBCRTstatic/dynamic: 控制C运行时库的链接方式。默认情况下它会跟随你的项目设置。但如果你要生成一个静态库modestatic并希望它完全不依赖MSVCRT.dll可以尝试设置为static这会使用/MT或/MTd标志。通常保持默认即可。GEN_PDByes/no: 是否生成程序数据库文件.pdb用于调试。即使在DEBUGno时设为yes也会生成Release版本的PDB对于后期排查崩溃问题很有用。ENABLE_IPV6yes/no: 是否启用IPv6支持。ENABLE_SSPIyes/no: 是否启用Windows原生SSPI认证支持用于NTLM等。在Windows上建议保持yes。ENABLE_WINSSLyes/no: 是否启用Windows原生的Schannel SSL后端代替OpenSSL。如果你不想依赖OpenSSL可以设为yesWITH_SSL就可以设为no了。但Schannel的功能可能没有OpenSSL全面。一个我常用的、功能较全的Release版静态库编译配置nmake /f Makefile.vc modestatic VC19 MACHINEx64 DEBUGno WITH_SSLstatic WITH_ZLIBstatic ENABLE_IPV6yes ENABLE_SSPIyes ENABLE_WINSSLno GEN_PDByes SSL_PATHD:\Dev\OpenSSL-Win64 ZLIB_PATHD:\Dev\zlib-1.2.13这个配置生成了一个支持SSL通过OpenSSL、zlib压缩、IPv6和Windows SSPI认证的静态库并且生成了PDB文件。4. 执行编译与构建产物分析配置命令准备就绪后在winbuild目录下执行它。第一次运行会先调用Perl处理Makefile.vc生成具体的构建文件然后开始漫长的编译过程。控制台会滚动输出编译信息。如果一切顺利最终你会看到类似“Build complete.”的提示。4.1 构建输出目录结构编译完成后生成的库文件并不在源码根目录而是在一个固定的输出路径下D:\Dev\curl-7.84.0\builds\。在这个目录下会根据你的配置参数生成一个很长的子目录名例如builds\libcurl-vc19-x64-release-static-ipv6-sspi-ssl-static-zlib-static这个长长的名字精确描述了库的属性vc19VS2019、x6464位、release发布版、static静态库、ipv6-sspi启用的功能、ssl-static-zlib-static依赖的库和链接方式。进入这个目录你会找到我们最终需要的文件libcurl.lib: 这就是Curl的静态库文件是你的项目需要链接的目标。bin/目录如果编译的是动态库modedll这里会有libcurl.dll。include/目录包含所有Curl的头文件如curl/curl.h你需要将它们拷贝到你的项目中或添加到包含路径。lib/目录实际上对于静态库libcurl.lib就在builds的根目录这个lib/目录可能存放一些中间文件或用于动态库的导入库。4.2 关键文件与集成准备现在为了在你的VS2019项目中使用这个自编译的库你需要准备以下文件头文件将builds\你的配置目录\include\curl\整个文件夹复制出来或者将builds\你的配置目录\include路径添加到项目的“附加包含目录”中。库文件将生成的libcurl.lib文件路径添加到项目的“附加库目录”中并在“链接器 - 输入 - 附加依赖项”里添加libcurl.lib。依赖的DLL如果动态链接如果你编译的是动态库modedll或者依赖项如OpenSSL、zlib是动态链接的WITH_SSLdll那么你需要将对应的DLL文件如libcurl.dll,libssl-1_1-x64.dll,libcrypto-1_1-x64.dll,zlib.dll放置在你的可执行文件同级目录或者放在系统PATH包含的目录下。实操心得我强烈建议在项目内创建一个专门的thirdparty或libs目录将自编译的include和lib文件按库名组织好。这样项目结构清晰也便于版本管理和团队协作。例如MyProject/ ├── src/ ├── include/ (项目自己的头文件) └── libs/ └── curl-7.84.0-vc19-x64-static/ ├── include/ │ └── curl/ └── lib/ └── libcurl.lib然后在VS项目属性中将$(ProjectDir)libs\curl-7.84.0-vc19-x64-static\include添加到包含目录将$(ProjectDir)libs\curl-7.84.0-vc19-x64-static\lib添加到库目录。5. 编译问题排查与实战经验编译过程很少一帆风顺尤其是依赖路径配置错误时。下面是我在编译Curl 7.84.0过程中遇到的一些典型问题及解决方法。5.1 常见错误与解决方案错误1:NMAKE : fatal error U1073: dont know how to make ...\openssl\lib\libssl.lib问题分析这是最常见的问题。nmake在指定的SSL_PATH下的lib目录中找不到libssl.lib文件。预编译的OpenSSL安装后其库文件可能位于lib\VC\子目录下对于静态库或者库文件名可能不同比如libssl-1_1-x64.lib。解决方案检查SSL_PATH路径是否正确确保路径中没有尾随空格或中文字符。打开SSL_PATH\lib目录查看里面到底有什么文件。如果你看到的是libssl-1_1-x64.lib和libcrypto-1_1-x64.lib那么你需要将它们重命名为libssl.lib和libcrypto.lib或者更优雅的办法是在lib目录下为它们创建副本或符号链接mklink。如果库文件在lib\VC\或lib\VC\static下你可以修改SSL_PATH指向D:\Dev\OpenSSL-Win64但将lib\VC\static下的所有.lib文件复制或链接到lib目录下。错误2:Cannot open include file: openssl/opensslv.h: No such file or directory问题分析编译器找不到OpenSSL的头文件。SSL_PATH指向的目录下必须有include子目录且include子目录下必须有openssl文件夹。解决方案检查SSL_PATH\include\openssl\opensslv.h文件是否存在。如果OpenSSL安装正确它应该存在。如果不存在可能是OpenSSL安装不完整重新安装或下载完整的开发包。错误3: 链接阶段报错LNK2001: 无法解析的外部符号 __imp_*问题分析这通常是库的链接方式不匹配造成的。比如你编译Curl时使用了WITH_SSLstatic意味着Curl静态链接了OpenSSL但你的项目在链接时除了libcurl.lib又额外链接了OpenSSL的动态库导入库如libssl.lib这会导致符号冲突或重复定义。反之亦然。解决方案确保一致性。如果你的Curl库是静态链接了所有依赖WITH_*static那么你的项目只需要链接libcurl.lib一个库不要再链接OpenSSL或zlib的库。清理项目附加依赖项只保留libcurl.lib。错误4: 运行时崩溃提示找不到VCRUNTIME140.dll或MSVCP140.dll问题分析这通常是运行时库CRT不匹配导致的。你用/MT静态链接CRT编译的库被一个用/MD动态链接CRT编译的项目使用或者反过来。解决方案在编译Curl时可以尝试显式指定RTLIBCRTstatic或dynamic使其与你的主项目设置一致。更简单的做法是在VS项目属性中确保“C/C - 代码生成 - 运行时库”设置一致。通常对于动态库DLL项目使用/MD或/MDd对于静态链接所有依赖的可执行文件使用/MT或/MTd。最保险的方法是将你的主项目和Curl库都用相同的设置如/MD编译。5.2 调试版本编译注意事项编译Debug版本DEBUGyes通常用于单步调试Curl内部代码。这时需要注意库文件名生成的静态库会叫libcurl_debug.lib以区别于Release版。依赖库你需要同样提供Debug版本的OpenSSL和zlib库通常文件名带d后缀如libssl-1_1-x64d.lib。如果找不到链接可能会失败。一种变通方法是在测试阶段暂时链接Release版的依赖库来编译Debug版的Curl但这不是推荐做法可能会在调试时引发细微问题。运行时库Debug版会自动使用调试运行时/MDd或/MTd确保你的测试项目也使用相同的设置。5.3 编译脚本自动化手动输入一长串nmake命令很容易出错。我通常会创建一个批处理文件build_curl.bat放在winbuild目录下echo off set VC19 set MACHINEx64 set DEBUGno set MODEstatic set SSL_PATHD:\Dev\OpenSSL-Win64 set ZLIB_PATHD:\Dev\zlib-1.2.13 echo Building curl in %MODE% mode for VC%VC% %MACHINE% (DEBUG%DEBUG%)... nmake /f Makefile.vc clean nmake /f Makefile.vc mode%MODE% VC%VC% MACHINE%MACHINE% DEBUG%DEBUG% WITH_SSLstatic WITH_ZLIBstatic ENABLE_IPV6yes ENABLE_SSPIyes GEN_PDByes SSL_PATH%SSL_PATH% ZLIB_PATH%ZLIB_PATH% if %ERRORLEVEL% EQU 0 ( echo. echo Build succeeded! echo Libraries are in: builds\libcurl-vc%VC%-%MACHINE%-%DEBUG%-%MODE%-... ) else ( echo. echo Build failed with error %ERRORLEVEL%. ) pause这样每次需要编译时只需双击运行这个批处理或者根据需要修改开头的变量即可大大提高了效率并减少了错误。6. 编译成果测试与验证库编译出来了但它真的能用吗最好的测试方法就是写一个简单的程序来调用它。6.1 创建测试项目在VS2019中创建一个新的“控制台应用”项目命名为curl_test。按照前面“集成准备”部分配置好头文件目录和库文件目录并在链接器输入中添加libcurl.lib。同时确保你的项目平台是x64运行时库设置与编译Curl时使用的相匹配如果不确定就都用/MD。6.2 编写测试代码下面是一个最简单的使用Curl获取网页内容的示例#include stdio.h #include curl/curl.h // 用于接收数据的回调函数 size_t write_data(void* buffer, size_t size, size_t nmemb, void* userp) { size_t total_size size * nmemb; printf(Received %zu bytes:\n%.*s\n, total_size, (int)total_size, (char*)buffer); return total_size; // 必须返回实际处理的数据大小 } int main(void) { CURL* curl; CURLcode res; // 初始化全局Curl环境 curl_global_init(CURL_GLOBAL_DEFAULT); // 获取一个Curl句柄 curl curl_easy_init(); if (curl) { // 设置要抓取的URL curl_easy_setopt(curl, CURLOPT_URL, https://httpbin.org/get); // 设置SSL证书验证为测试方便生产环境应开启 curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); // 设置接收数据的回调函数 curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data); // 执行请求 res curl_easy_perform(curl); // 检查错误 if (res ! CURLE_OK) { fprintf(stderr, curl_easy_perform() failed: %s\n, curl_easy_strerror(res)); } // 清理句柄 curl_easy_cleanup(curl); } // 清理全局环境 curl_global_cleanup(); return 0; }6.3 运行与调试编译并运行这个测试程序。如果一切配置正确你应该能在控制台看到从https://httpbin.org/get返回的JSON数据。这证明你的Curl库已经成功编译并且SSL功能工作正常。如果程序崩溃或没有任何输出检查依赖DLL如果你的Curl或OpenSSL是动态链接的请将libcurl.dll、libssl-1_1-x64.dll、libcrypto-1_1-x64.dll、zlib.dll复制到你的curl_test.exe所在目录。调试运行在Debug模式下运行看是否有断言失败或异常抛出。使用Depends工具可以使用像Dependencies这样的工具打开你的curl_test.exe查看它运行时究竟加载了哪些DLL是否有缺失。通过这个完整的流程——从环境搭建、依赖配置、编译构建到最终测试——你不仅获得了一个量身定制的Curl库更深入理解了Windows下开源库的编译生态。下次遇到其他需要编译的库比如libssh2或nghttp2你也可以举一反三用类似的思路去解决问题。自己编译虽然前期花费一些时间但换来的是项目的长期稳定和可控这份投入对于严肃的项目来说是非常值得的。本文还有配套的精品资源点击获取 
长河君 · 2026/8/30 18:45:55 · 阅读 1.2k Windows 10下使用VS2019编译64位Curl 7.84.0静态库完整指南
简介本资源是为Windows 10平台开发者提供的、基于Visual Studio 2019预编译完成的64位cURL静态/动态链接库版本7.84.0当前稳定最新版完整支持HTTPS协议及SSL/TLS加密通信适用于C/C网络编程、HTTP客户端开发、自动化脚本集成等场景尤其适合刚接触网络库编译或希望跳过复杂构建流程的中初级开发者。压缩包共19个文件包含头文件.h、导入库.lib、导出符号文件.exp、运行时DLL、可执行程序curl.exe及构建说明文档README.md结构已按标准lib/include目录组织开箱即用。资源体积仅354KB轻量紧凑便于嵌入项目或快速验证。目前已有774人学习下载附带的curl.exe可直接用于命令行HTTP调试配合头文件与库文件能立即开展GET/POST/上传下载等全功能开发实践显著降低环境搭建门槛。1. 项目概述与背景在Windows平台上进行C/C开发尤其是涉及到网络通信、文件传输或API调用时一个稳定可靠的HTTP客户端库几乎是不可或缺的基础设施。Curl这个由Daniel Stenberg创建的开源项目凭借其强大的协议支持HTTP/HTTPS、FTP、SMTP等、高度的可移植性和活跃的社区成为了无数开发者的首选。然而对于Windows开发者特别是使用Visual Studio生态的开发者来说直接使用Curl官方提供的预编译二进制包有时并不能完全满足需求。比如你可能需要链接到特定的运行时库MT/MTd vs MD/MDd或者需要针对特定的OpenSSL版本进行编译又或者官方提供的版本与你项目所使用的Visual Studio版本不匹配导致链接错误或运行时崩溃。这正是我决定在Windows 10环境下使用Visual Studio 2019手动编译64位Curl库版本7.84.0的初衷。7.84.0是一个相对稳定且功能完善的版本修复了之前版本的一些安全问题同时API也保持稳定。自己动手编译意味着你可以完全掌控构建过程选择所需的第三方依赖如OpenSSL、zlib、配置编译选项如是否启用SSL、IPv6、HTTP/2、以及生成适用于你项目配置Debug/Release 动态库/静态库的二进制文件。这个过程虽然有些繁琐但一旦完成你将获得一个与你的开发环境完美契合的“定制化”工具库后续的集成和调试都会顺畅许多。这篇文章就是记录我从环境准备、依赖配置、编译构建到最终测试的完整过程以及其中踩过的坑和总结的经验希望能为有同样需求的开发者提供一份清晰的“避坑指南”。2. 编译环境与工具链准备工欲善其事必先利其器。在开始编译Curl之前确保你的开发环境是正确且完整的这是避免后续一系列诡异错误的第一步。2.1 操作系统与Visual Studio 2019我的基础环境是Windows 10 专业版 64位版本号最好是比较新的比如20H2或更高以确保系统组件和SDK的完整性。核心工具是Visual Studio 2019 Community/Professional/Enterprise版本。我使用的是VS2019专业版但社区版完全足够。关键在于安装时必须勾选“使用C的桌面开发”工作负载。注意仅仅安装VS2019是不够的必须确保包含了对应的Windows SDK和MSVC工具集。在VS安装程序的“单个组件”选项卡中搜索并确认安装了与你VS2019版本匹配的“Windows 10 SDK”和“MSVC v142 - VS 2019 C x64/x86 生成工具”。我推荐使用Windows 10 SDK (10.0.19041.0) 或更高版本。安装完成后为了能在命令行中直接使用cl、nmake等编译工具你需要打开“适用于VS 2019的 x64 本机工具命令提示符”。这个快捷方式位于开始菜单的Visual Studio 2019文件夹下。它会自动设置好所有必要的环境变量如INCLUDE、LIB、PATH这是后续使用nmake编译的关键。千万不要使用普通的CMD或PowerShell否则会找不到编译器。2.2 Curl源码与Perl环境接下来是获取源码。前往Curl的官方GitHub发布页面找到版本7.84.0的源代码压缩包通常是curl-7.84.0.tar.gz。下载后解压到一个没有中文和空格的路径下例如D:\Dev\curl-7.84.0。这就是我们的工作目录。Curl在Windows下的构建系统依赖于一个古老的但至关重要的工具Perl。这是因为其构建配置文件Makefile.vc需要Perl来进行预处理。你需要安装一个Windows版本的Perl。我推荐使用Strawberry Perl因为它自带了许多有用的工具并且安装简单。从官网下载安装程序一路下一步即可。安装后同样需要确保Perl的可执行文件路径例如C:\Strawberry\perl\bin被添加到了系统的PATH环境变量中或者在VS命令提示符下该路径是可见的。你可以在VS命令提示符中输入perl -v来验证是否安装成功。2.3 第三方依赖库OpenSSL与zlibCurl的强大功能离不开其第三方依赖。对于最基本的HTTPS支持我们需要OpenSSL库。在Windows下编译OpenSSL本身又是一个大工程为了简化我强烈建议直接使用预编译好的二进制包。Shining Light Productions 网站提供了非常完善的Windows预编译OpenSSL库我们选择与VS2019匹配的版本。下载OpenSSL访问相关资源站下载适用于Visual Studio 2019的64位版本。例如选择Win64 OpenSSL v1.1.1x Light或Win64 OpenSSL v3.0.x Light。Light版本只包含库文件足够我们使用。我选择的是OpenSSL 1.1.1s因为它非常稳定且兼容性广。下载的是一个安装程序运行它并安装到一个简单路径比如D:\Dev\OpenSSL-Win64。下载zlibzlib用于压缩解压缩很多HTTP传输会用到。同样我们可以使用预编译版本。从zlib官网或相关资源站下载zlib compiled DLL。我使用的是zlib 1.2.13的预编译包。解压后你会得到zlib.lib、zlib.dll和头文件。现在你的依赖库目录结构应该类似这样D:\Dev\ ├── curl-7.84.0\ (Curl源码) ├── OpenSSL-Win64\ (OpenSSL包含lib, include, bin目录) └── zlib-1.2.13\ (zlib包含 lib, include, dll 文件)3. 编译配置与参数详解准备好所有材料后我们就可以开始“烹饪”了。编译的核心在于一个叫Makefile.vc的文件我们需要用Perl来生成针对我们环境的特定Makefile。3.1 生成定制的Makefile首先用之前提到的“x64本机工具命令提示符”导航到Curl源码目录cd D:\Dev\curl-7.84.0\winbuildwinbuild目录是专门为Windows的NMake构建准备的。接下来使用nmake命令配合Makefile.vc来构建。但直接运行前我们需要通过参数告诉它我们的配置。一个最基础的、支持SSL的静态库编译命令如下nmake /f Makefile.vc modestatic VC19 MACHINEx64 DEBUGno WITH_SSLstatic WITH_ZLIBstatic SSL_PATHD:\Dev\OpenSSL-Win64 ZLIB_PATHD:\Dev\zlib-1.2.13让我详细解释一下每个参数的含义这是理解整个构建过程的关键nmake /f Makefile.vc: 指定使用NMake工具并采用Makefile.vc这个模板文件。modestatic: 这是我们生成库的类型。static表示生成静态库.lib文件你的程序在链接时会将这些代码直接打包进你的exe。另一个选项是dll生成动态链接库.dll和.lib。选择建议如果你希望分发程序时不需要附带额外的DLL文件或者避免DLL版本冲突就用static。但这样会导致你的可执行文件体积变大。如果多个模块都要用curl用dll可以节省空间。VC19: 这指定了Visual Studio的版本号。VS2019对应的是16但这里用的是编译器工具集版本v142的内部代号19。这是一个关键点必须正确。VS2017是15VS2022是17。MACHINEx64: 目标平台是64位。如果需要32位库则使用x86。DEBUGno: 生成Release版本的库优化级别高不带调试信息。如果需要调试则设为yes会生成带调试信息的.pdb文件和未优化的代码。WITH_SSLstatic: 指定使用OpenSSL并且以静态链接的方式链接到Curl库中。这意味着OpenSSL的代码也会被整合进最终的libcurl.lib里。如果这里用dll则需要运行时提供libssl-1_1-x64.dll等文件。重要选择static还是dll必须和你的OpenSSL库本身类型匹配。我们下载的预编译OpenSSL通常同时提供了静态库.lib和动态库.dll.lib。如果你指定WITH_SSLstatic那么nmake会去寻找libssl.lib和libcrypto.lib静态库。如果你指定WITH_SSLdll它会去寻找libssl.lib和libcrypto.lib动态库的导入库以及对应的DLL。WITH_ZLIBstatic: 类似地指定使用zlib并静态链接。SSL_PATHD:\Dev\OpenSSL-Win64:这是最容易出错的地方之一。这个路径必须指向你的OpenSSL安装的根目录在这个目录下nmake期望找到include子目录包含头文件和lib子目录包含库文件。预编译的OpenSSL安装后通常符合这个结构。ZLIB_PATHD:\Dev\zlib-1.2.13: 同理指向zlib的根目录需要包含include和lib子目录。3.2 高级配置选项与常见组合除了上述基本参数Makefile.vc还支持很多其他选项让你可以精细控制Curl的功能。RTLIBCRTstatic/dynamic: 控制C运行时库的链接方式。默认情况下它会跟随你的项目设置。但如果你要生成一个静态库modestatic并希望它完全不依赖MSVCRT.dll可以尝试设置为static这会使用/MT或/MTd标志。通常保持默认即可。GEN_PDByes/no: 是否生成程序数据库文件.pdb用于调试。即使在DEBUGno时设为yes也会生成Release版本的PDB对于后期排查崩溃问题很有用。ENABLE_IPV6yes/no: 是否启用IPv6支持。ENABLE_SSPIyes/no: 是否启用Windows原生SSPI认证支持用于NTLM等。在Windows上建议保持yes。ENABLE_WINSSLyes/no: 是否启用Windows原生的Schannel SSL后端代替OpenSSL。如果你不想依赖OpenSSL可以设为yesWITH_SSL就可以设为no了。但Schannel的功能可能没有OpenSSL全面。一个我常用的、功能较全的Release版静态库编译配置nmake /f Makefile.vc modestatic VC19 MACHINEx64 DEBUGno WITH_SSLstatic WITH_ZLIBstatic ENABLE_IPV6yes ENABLE_SSPIyes ENABLE_WINSSLno GEN_PDByes SSL_PATHD:\Dev\OpenSSL-Win64 ZLIB_PATHD:\Dev\zlib-1.2.13这个配置生成了一个支持SSL通过OpenSSL、zlib压缩、IPv6和Windows SSPI认证的静态库并且生成了PDB文件。4. 执行编译与构建产物分析配置命令准备就绪后在winbuild目录下执行它。第一次运行会先调用Perl处理Makefile.vc生成具体的构建文件然后开始漫长的编译过程。控制台会滚动输出编译信息。如果一切顺利最终你会看到类似“Build complete.”的提示。4.1 构建输出目录结构编译完成后生成的库文件并不在源码根目录而是在一个固定的输出路径下D:\Dev\curl-7.84.0\builds\。在这个目录下会根据你的配置参数生成一个很长的子目录名例如builds\libcurl-vc19-x64-release-static-ipv6-sspi-ssl-static-zlib-static这个长长的名字精确描述了库的属性vc19VS2019、x6464位、release发布版、static静态库、ipv6-sspi启用的功能、ssl-static-zlib-static依赖的库和链接方式。进入这个目录你会找到我们最终需要的文件libcurl.lib: 这就是Curl的静态库文件是你的项目需要链接的目标。bin/目录如果编译的是动态库modedll这里会有libcurl.dll。include/目录包含所有Curl的头文件如curl/curl.h你需要将它们拷贝到你的项目中或添加到包含路径。lib/目录实际上对于静态库libcurl.lib就在builds的根目录这个lib/目录可能存放一些中间文件或用于动态库的导入库。4.2 关键文件与集成准备现在为了在你的VS2019项目中使用这个自编译的库你需要准备以下文件头文件将builds\你的配置目录\include\curl\整个文件夹复制出来或者将builds\你的配置目录\include路径添加到项目的“附加包含目录”中。库文件将生成的libcurl.lib文件路径添加到项目的“附加库目录”中并在“链接器 - 输入 - 附加依赖项”里添加libcurl.lib。依赖的DLL如果动态链接如果你编译的是动态库modedll或者依赖项如OpenSSL、zlib是动态链接的WITH_SSLdll那么你需要将对应的DLL文件如libcurl.dll,libssl-1_1-x64.dll,libcrypto-1_1-x64.dll,zlib.dll放置在你的可执行文件同级目录或者放在系统PATH包含的目录下。实操心得我强烈建议在项目内创建一个专门的thirdparty或libs目录将自编译的include和lib文件按库名组织好。这样项目结构清晰也便于版本管理和团队协作。例如MyProject/ ├── src/ ├── include/ (项目自己的头文件) └── libs/ └── curl-7.84.0-vc19-x64-static/ ├── include/ │ └── curl/ └── lib/ └── libcurl.lib然后在VS项目属性中将$(ProjectDir)libs\curl-7.84.0-vc19-x64-static\include添加到包含目录将$(ProjectDir)libs\curl-7.84.0-vc19-x64-static\lib添加到库目录。5. 编译问题排查与实战经验编译过程很少一帆风顺尤其是依赖路径配置错误时。下面是我在编译Curl 7.84.0过程中遇到的一些典型问题及解决方法。5.1 常见错误与解决方案错误1:NMAKE : fatal error U1073: dont know how to make ...\openssl\lib\libssl.lib问题分析这是最常见的问题。nmake在指定的SSL_PATH下的lib目录中找不到libssl.lib文件。预编译的OpenSSL安装后其库文件可能位于lib\VC\子目录下对于静态库或者库文件名可能不同比如libssl-1_1-x64.lib。解决方案检查SSL_PATH路径是否正确确保路径中没有尾随空格或中文字符。打开SSL_PATH\lib目录查看里面到底有什么文件。如果你看到的是libssl-1_1-x64.lib和libcrypto-1_1-x64.lib那么你需要将它们重命名为libssl.lib和libcrypto.lib或者更优雅的办法是在lib目录下为它们创建副本或符号链接mklink。如果库文件在lib\VC\或lib\VC\static下你可以修改SSL_PATH指向D:\Dev\OpenSSL-Win64但将lib\VC\static下的所有.lib文件复制或链接到lib目录下。错误2:Cannot open include file: openssl/opensslv.h: No such file or directory问题分析编译器找不到OpenSSL的头文件。SSL_PATH指向的目录下必须有include子目录且include子目录下必须有openssl文件夹。解决方案检查SSL_PATH\include\openssl\opensslv.h文件是否存在。如果OpenSSL安装正确它应该存在。如果不存在可能是OpenSSL安装不完整重新安装或下载完整的开发包。错误3: 链接阶段报错LNK2001: 无法解析的外部符号 __imp_*问题分析这通常是库的链接方式不匹配造成的。比如你编译Curl时使用了WITH_SSLstatic意味着Curl静态链接了OpenSSL但你的项目在链接时除了libcurl.lib又额外链接了OpenSSL的动态库导入库如libssl.lib这会导致符号冲突或重复定义。反之亦然。解决方案确保一致性。如果你的Curl库是静态链接了所有依赖WITH_*static那么你的项目只需要链接libcurl.lib一个库不要再链接OpenSSL或zlib的库。清理项目附加依赖项只保留libcurl.lib。错误4: 运行时崩溃提示找不到VCRUNTIME140.dll或MSVCP140.dll问题分析这通常是运行时库CRT不匹配导致的。你用/MT静态链接CRT编译的库被一个用/MD动态链接CRT编译的项目使用或者反过来。解决方案在编译Curl时可以尝试显式指定RTLIBCRTstatic或dynamic使其与你的主项目设置一致。更简单的做法是在VS项目属性中确保“C/C - 代码生成 - 运行时库”设置一致。通常对于动态库DLL项目使用/MD或/MDd对于静态链接所有依赖的可执行文件使用/MT或/MTd。最保险的方法是将你的主项目和Curl库都用相同的设置如/MD编译。5.2 调试版本编译注意事项编译Debug版本DEBUGyes通常用于单步调试Curl内部代码。这时需要注意库文件名生成的静态库会叫libcurl_debug.lib以区别于Release版。依赖库你需要同样提供Debug版本的OpenSSL和zlib库通常文件名带d后缀如libssl-1_1-x64d.lib。如果找不到链接可能会失败。一种变通方法是在测试阶段暂时链接Release版的依赖库来编译Debug版的Curl但这不是推荐做法可能会在调试时引发细微问题。运行时库Debug版会自动使用调试运行时/MDd或/MTd确保你的测试项目也使用相同的设置。5.3 编译脚本自动化手动输入一长串nmake命令很容易出错。我通常会创建一个批处理文件build_curl.bat放在winbuild目录下echo off set VC19 set MACHINEx64 set DEBUGno set MODEstatic set SSL_PATHD:\Dev\OpenSSL-Win64 set ZLIB_PATHD:\Dev\zlib-1.2.13 echo Building curl in %MODE% mode for VC%VC% %MACHINE% (DEBUG%DEBUG%)... nmake /f Makefile.vc clean nmake /f Makefile.vc mode%MODE% VC%VC% MACHINE%MACHINE% DEBUG%DEBUG% WITH_SSLstatic WITH_ZLIBstatic ENABLE_IPV6yes ENABLE_SSPIyes GEN_PDByes SSL_PATH%SSL_PATH% ZLIB_PATH%ZLIB_PATH% if %ERRORLEVEL% EQU 0 ( echo. echo Build succeeded! echo Libraries are in: builds\libcurl-vc%VC%-%MACHINE%-%DEBUG%-%MODE%-... ) else ( echo. echo Build failed with error %ERRORLEVEL%. ) pause这样每次需要编译时只需双击运行这个批处理或者根据需要修改开头的变量即可大大提高了效率并减少了错误。6. 编译成果测试与验证库编译出来了但它真的能用吗最好的测试方法就是写一个简单的程序来调用它。6.1 创建测试项目在VS2019中创建一个新的“控制台应用”项目命名为curl_test。按照前面“集成准备”部分配置好头文件目录和库文件目录并在链接器输入中添加libcurl.lib。同时确保你的项目平台是x64运行时库设置与编译Curl时使用的相匹配如果不确定就都用/MD。6.2 编写测试代码下面是一个最简单的使用Curl获取网页内容的示例#include stdio.h #include curl/curl.h // 用于接收数据的回调函数 size_t write_data(void* buffer, size_t size, size_t nmemb, void* userp) { size_t total_size size * nmemb; printf(Received %zu bytes:\n%.*s\n, total_size, (int)total_size, (char*)buffer); return total_size; // 必须返回实际处理的数据大小 } int main(void) { CURL* curl; CURLcode res; // 初始化全局Curl环境 curl_global_init(CURL_GLOBAL_DEFAULT); // 获取一个Curl句柄 curl curl_easy_init(); if (curl) { // 设置要抓取的URL curl_easy_setopt(curl, CURLOPT_URL, https://httpbin.org/get); // 设置SSL证书验证为测试方便生产环境应开启 curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); // 设置接收数据的回调函数 curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data); // 执行请求 res curl_easy_perform(curl); // 检查错误 if (res ! CURLE_OK) { fprintf(stderr, curl_easy_perform() failed: %s\n, curl_easy_strerror(res)); } // 清理句柄 curl_easy_cleanup(curl); } // 清理全局环境 curl_global_cleanup(); return 0; }6.3 运行与调试编译并运行这个测试程序。如果一切配置正确你应该能在控制台看到从https://httpbin.org/get返回的JSON数据。这证明你的Curl库已经成功编译并且SSL功能工作正常。如果程序崩溃或没有任何输出检查依赖DLL如果你的Curl或OpenSSL是动态链接的请将libcurl.dll、libssl-1_1-x64.dll、libcrypto-1_1-x64.dll、zlib.dll复制到你的curl_test.exe所在目录。调试运行在Debug模式下运行看是否有断言失败或异常抛出。使用Depends工具可以使用像Dependencies这样的工具打开你的curl_test.exe查看它运行时究竟加载了哪些DLL是否有缺失。通过这个完整的流程——从环境搭建、依赖配置、编译构建到最终测试——你不仅获得了一个量身定制的Curl库更深入理解了Windows下开源库的编译生态。下次遇到其他需要编译的库比如libssh2或nghttp2你也可以举一反三用类似的思路去解决问题。自己编译虽然前期花费一些时间但换来的是项目的长期稳定和可控这份投入对于严肃的项目来说是非常值得的。本文还有配套的精品资源点击获取