C++程序静态链接libcurl失败：跨机运行报错及编译问题求助

原问题与现象 #

目标是将libcurl静态链接到C++程序，消除DLL依赖以实现跨机器运行。操作步骤：

1. 通过vcpkg执行vcpkg install curl安装curl
2. 配置Visual Studio Release x64项目：
   • C/C++：附加包含目录设为C:\dev\vcpkg\installed\x64-windows\include，预处理器定义添加CURL_STATICLIB，运行库设为Multi-threaded (/MT)
   • 链接器：附加库目录设为C:\dev\vcpkg\installed\x64-windows\lib，附加依赖项添加libcrypto.lib; libssl.lib; libcurl.lib

项目编译通过且本机可正常运行，但在其他机器上弹出错误：

程序无法启动，因为计算机中丢失libcurl.dll。
尝试重新安装该程序以解决此问题。

疑问：

• 配置是否存在错误？
• libcurl是否支持静态链接？
• 为何其他库无此类依赖问题？
• 求推荐支持静态编译的易用C++ HTTP请求库。

更新后的问题 #

按指南安装了静态版本curl:x64-windows-static，手动及自动配置链接静态版libcurl.lib后，项目编译失败，编译日志翻译如下：

1>main.obj : 错误 LNK2019: 无法解析的外部符号 __imp_curl_easy_init，函数 _main 中引用了该符号
1>main.obj : 错误 LNK2019: 无法解析的外部符号 __imp_curl_easy_setopt，函数 _main 中引用了该符号
1>main.obj : 错误 LNK2019: 无法解析的外部符号 __imp_curl_easy_perform，函数 _main 中引用了该符号
1>main.obj : 错误 LNK2019: 无法解析的外部符号 __imp_curl_easy_cleanup，函数 _main 中引用了该符号
1>C:\xxx\Release\Project1.exe : 致命错误 LNK1120: 4 个无法解析的外部命令

问题原因与解决方案 #

原问题根源 #

你最初安装的curl是动态库版本（x64-windows），配置中链接的libcurl.lib是动态库的导入库而非静态库，因此程序仍会依赖libcurl.dll。

静态链接的正确配置流程 #

1. 安装静态版本curl：

   vcpkg install curl:x64-windows-static
   

2. 调整Visual Studio项目配置（Release x64）：
   • C/C++ → 常规：附加包含目录改为C:\dev\vcpkg\installed\x64-windows-static\include
   • C/C++ → 预处理器：确保添加CURL_STATICLIB（该宏是静态链接的必要条件，未定义会按动态库方式编译代码）
   • C/C++ → 代码生成：运行库保持Multi-threaded (/MT)（使用静态C运行时，避免依赖MSVCRT系列DLL）
   • 链接器 → 常规：附加库目录改为C:\dev\vcpkg\installed\x64-windows-static\lib
   • 链接器 → 输入：附加依赖项需包含静态curl的全部依赖库，完整列表为：

     libcurl.lib;libcrypto.lib;libssl.lib;ws2_32.lib;wldap32.lib;crypt32.lib;normaliz.lib
     

     （这些是curl静态编译时依赖的系统库与OpenSSL组件）

更新后编译失败的修复 #

出现__imp_*未解析符号，是以下原因导致：

• 未正确定义CURL_STATICLIB宏，代码仍按动态库方式生成引用
• 库路径仍指向动态库版本的x64-windows\lib
• 链接的libcurl.lib并非静态版本

对应修复：

1. 检查预处理器定义，确保CURL_STATICLIB存在且未被覆盖
2. 确认附加库目录是x64-windows-static\lib
3. 清理项目缓存后重新编译

支持静态编译的C++ HTTP库推荐 #

• cpp-httplib：轻量级单头文件库，API简洁易用，支持HTTP/HTTPS，可静态编译，启用HTTPS需依赖OpenSSL
• Boost.Beast：Boost生态组件，功能全面，支持HTTP/HTTPS/WebSocket，可静态编译，适合复杂网络场景
• Pistache：现代C++ HTTP库，支持同步/异步请求，可静态编译，设计风格贴近现代C++特性

内容的提问来源于stack exchange，提问作者GooDeeJAY