使用 vcpkg 构建支持 HTTPS 的 libcurl 并解决常见链接错误
适用环境：Windows 10/11 + Visual Studio 2022 + CMake ≥ 3.20
目标读者：希望在 C++ 项目中轻松调用 HTTPS（GET/POST/PUT/DELETE），又被 LNK20xx 链接错误困扰的开发者
目录
- 为什么选 vcpkg 与 libcurl
- 用 vcpkg 安装带 SSL 的 libcurl
- CMake 最小工程模板
- HTTPS GET/POST/PUT/DELETE 封装示例
- 链接错误排查：
__imp_CertOpenStore等无法解析 - LNK4098 运行库冲突的本质与解决
- 小结与最佳实践
1. 为什么选 vcpkg 与 libcurl
- libcurl 跨平台、成熟，支持 HTTP2、HTTP3、FTP、SFTP…；只想做简单 REST 调用也完全够用。
- vcpkg 由微软维护，直接给 VS / CMake 注入正确的头文件、库路径、依赖链，省去 “到处找 *.lib” 的痛苦。
- 对 Windows 而言，HTTPS 有两条后端：OpenSSL（跨平台一致）或 Schannel（调用系统 SSL）。文中使用 openssl 变体，切换只需改个 triplet 选项。
2. 用 vcpkg 安装带 SSL 的 libcurl
# ① 克隆 vcpkg（已有可跳过）
git clone https://github.com/microsoft/vcpkg
.\vcpkg\bootstrap-vcpkg.bat# ② 安装 libcurl + openssl
.\vcpkg\vcpkg install curl[openssl] # 默认动态库 /MD# ③ 将 vcpkg 集成到 VS/MSBuild（只需一次）
.\vcpkg\vcpkg integrate install
若偏好系统 Schannel：vcpkg install curl[schannel]。
3. CMake 最小工程模板
your-project/├─ CMakeLists.txt└─ main.cpp
cmake_minimum_required(VERSION 3.20)
project(http_demo LANGUAGES CXX)# 若没做 integrate，可取消注释下一行
# set(CMAKE_TOOLCHAIN_FILE "路径到/vcpkg/scripts/buildsystems/vcpkg.cmake")find_package(CURL CONFIG REQUIRED)add_executable(http_demo main.cpp)
target_link_libraries(http_demo PRIVATE CURL::libcurl)set_target_properties(http_demo PROPERTIESCXX_STANDARD 17CXX_STANDARD_REQUIRED ON)
4. HTTPS GET/POST/PUT/DELETE 封装示例
#include <curl/curl.h>
#include <iostream>
#include <vector>
#include <string>static size_t write_cb(char* p, size_t s, size_t n, void* ud)
{auto* buf = static_cast<std::string*>(ud);buf->append(p, s * n);return s * n;
}// 通用请求
CURLcode request(const std::string& url, const std::string& verb,const std::string& body,const std::vector<std::string>& headers,bool ignore_cert, std::string& out, long& status)
{CURL* h = curl_easy_init();if (!h) return CURLE_FAILED_INIT;struct curl_slist* hs = nullptr;for (auto& it : headers) hs = curl_slist_append(hs, it.c_str());curl_easy_setopt(h, CURLOPT_URL, url.c_str());curl_easy_setopt(h, CURLOPT_CUSTOMREQUEST, verb.c_str());curl_easy_setopt(h, CURLOPT_HTTPHEADER, hs);curl_easy_setopt(h, CURLOPT_WRITEFUNCTION, write_cb);curl_easy_setopt(h, CURLOPT_WRITEDATA, &out);if (verb == "POST" || verb == "PUT")curl_easy_setopt(h, CURLOPT_POSTFIELDS, body.c_str());if (ignore_cert) {curl_easy_setopt(h, CURLOPT_SSL_VERIFYPEER, 0L);curl_easy_setopt(h, CURLOPT_SSL_VERIFYHOST, 0L);}curl_easy_setopt(h, CURLOPT_FOLLOWLOCATION, 1L);auto rc = curl_easy_perform(h);curl_easy_getinfo(h, CURLINFO_RESPONSE_CODE, &status);curl_slist_free_all(hs);curl_easy_cleanup(h);return rc;
}// 便捷包装
#define DECL(NAME, VERB) \std::string NAME(const std::string& url, const std::string& body = "",\const std::vector<std::string>& hdr = {}, bool nocert = false)\{ std::string r; long st; request(url, VERB, body, hdr, nocert, r, st);\std::cout << '[' << VERB << "] " << st << '\n'; return r; }DECL(get_, "GET")
DECL(del_, "DELETE")
DECL(post_, "POST")
DECL(put_, "PUT")int main()
{curl_global_init(CURL_GLOBAL_DEFAULT);std::cout << get_("https://self-signed.badssl.com/", "", {}, true).substr(0, 80) << "...\n";std::vector<std::string> h = { "Content-Type: application/json" };post_("https://httpbin.org/post", R"({"k":"v"})", h, true);curl_global_cleanup();
}
5. 链接错误排查
症状
error LNK2019: 无法解析的外部符号 __imp_CertOpenStore
warning LNK4098: 默认库 "LIBCMT" 与其他库的使用冲突
根因
- 静态版 libcurl / openssl 依赖 Crypt32.lib / Secur32.lib / Ws2_32.lib …，未加入链接器。
- 你的工程用
/MT静态 CRT，而 vcpkg 发行包是/MD动态 CRT，导致 LIBCMT 与 MSVCRT 冲突。
解决
首选办法——交给 vcpkg & CMake：
find_package(CURL CONFIG REQUIRED)
target_link_libraries(<exe> PRIVATE CURL::libcurl)
vcpkg 自动把系统库也传给链接器；且其 triplet 与你的运行库设置匹配，无需手工维护依赖表。
若手动指定库：
libcurl.lib;libssl.lib;libcrypto.lib;zlib.lib;
ws2_32.lib;wldap32.lib;crypt32.lib;secur32.lib;normaliz.lib;bcrypt.lib;
advapi32.lib;version.lib
统一运行库：
VS ‣ 项目属性 ‣ C/C++ ‣ 代码生成 ‣ 运行库 → /MD（Debug 选 /MDd）。
保持全部第三方库一致即可消除 LNK4098。
6. CRT 冲突深挖（可选阅读）
/MD链接到vcruntime140.dll,ucrtbase.dll，执行时动态加载；/MT把 CRT 代码打包进目标程序。
二者 ABI 完全一样，但把两套实现塞进同一个进程会让链接器难以解析同名符号，最终触发 LNK4098。
一条规则：所有目标 + 第三方库保持同一运行库选项。
7. 小结与最佳实践
- 使用
vcpkg integrate install+CURL::libcurl，可省去繁琐的手动依赖管理。 - HTTPS 后端任选 openssl / schannel，只需更改 vcpkg feature。
- 遇到
__imp_Cert*未解析 ⇒ 缺 Crypt32.lib 等系统库；
遇到 LNK4098 ⇒ 运行库/MDvs/MT不一致。 - 示例中的封装函数已支持 GET/POST/PUT/DELETE；
生产环境请提供 CA 链而非ignore_cert=true。 - 建议把 vcpkg triplet 与项目运行库 写进
vcpkg.json+CMakePresets.json以保持团队一致性。
至此，你就拥有了一套可直接在 Windows 上进行 HTTPS 调用的干净工程，并掌握了排雷思路。祝编码愉快!
附录:
更靠谱的类封装
class CurlEasy {
public:
CurlEasy() {
handle_ = curl_easy_init();
if (!handle_) throw std::runtime_error("curl_easy_init failed");
// 通用选项
curl_easy_setopt(handle_, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(handle_, CURLOPT_ACCEPT_ENCODING, ""); // 自动解压 gzip/deflate
curl_easy_setopt(handle_, CURLOPT_NOPROGRESS, 1L);
}
~CurlEasy() { if (handle_) curl_easy_cleanup(handle_); }
// 禁止拷贝，允许移动
CurlEasy(const CurlEasy&) = delete;
CurlEasy& operator=(const CurlEasy&) = delete;
CurlEasy(CurlEasy&&) = default;
CurlEasy& operator=(CurlEasy&&) = default;
struct Response {
long status{};
std::vector<byte> body; // 原始字节，不会被空字符截断
std::string headers; // 原样拼接的请求头，可自行解析
};
Response request(const std::string& url,
const std::string& verb = "GET",
const std::vector<byte>& body = {},
const std::vector<std::string>& hdr = {},
bool ignore_cert = false)
{
set_basic(url, verb, body, hdr, ignore_cert);
resp_.body.clear();
resp_.headers.clear();
curl_easy_setopt(handle_, CURLOPT_WRITEDATA, &resp_.body);
curl_easy_setopt(handle_, CURLOPT_WRITEFUNCTION, &CurlEasy::write_body);
curl_easy_setopt(handle_, CURLOPT_HEADERDATA, &resp_.headers);
curl_easy_setopt(handle_, CURLOPT_HEADERFUNCTION, &CurlEasy::write_header);
auto code = curl_easy_perform(handle_);
if (code != CURLE_OK)
throw std::runtime_error(curl_easy_strerror(code));
curl_easy_getinfo(handle_, CURLINFO_RESPONSE_CODE, &resp_.status);
return resp_;
}
private:
static size_t write_body(char* p, size_t sz, size_t nm, void* ud) {
auto* vec = static_cast<std::vector<byte>*>(ud);
vec->insert(vec->end(),
reinterpret_cast<byte*>(p),
reinterpret_cast<byte*>(p) + sz * nm);
return sz * nm;
}
static size_t write_header(char* p, size_t sz, size_t nm, void* ud) {
auto* s = static_cast<std::string*>(ud);
s->append(p, sz * nm);
return sz * nm;
}
void set_basic(const std::string& url, const std::string& verb,
const std::vector<byte>& body,
const std::vector<std::string>& hdr,
bool ignore_cert)
{
curl_easy_setopt(handle_, CURLOPT_URL, url.c_str());
if (verb == "GET")
curl_easy_setopt(handle_, CURLOPT_HTTPGET, 1L);
else if (verb == "POST" || verb == "PUT") {
curl_easy_setopt(handle_, CURLOPT_CUSTOMREQUEST, verb.c_str());
curl_easy_setopt(handle_, CURLOPT_POSTFIELDS, body.data());
curl_easy_setopt(handle_, CURLOPT_POSTFIELDSIZE, body.size());
}
else
curl_easy_setopt(handle_, CURLOPT_CUSTOMREQUEST, verb.c_str());
// 头
struct curl_slist* list = nullptr;
for (auto& h : hdr) list = curl_slist_append(list, h.c_str());
curl_easy_setopt(handle_, CURLOPT_HTTPHEADER, list);
// 证书
if (ignore_cert) {
curl_easy_setopt(handle_, CURLOPT_SSL_VERIFYPEER, 0L);
curl_easy_setopt(handle_, CURLOPT_SSL_VERIFYHOST, 0L);
}
}
CURL* handle_{};
Response resp_{};
};
int main() { curl_global_init(CURL_GLOBAL_DEFAULT); try { CurlEasy curl; auto res = curl.request("https://httpbin.org/gzip"); // gzip 压缩 JSON std::cout << "HTTP " << res.status << " , body bytes = " << res.body.size() << '\n'; // 若确定是文本，可安全构造字符串 std::string text(reinterpret_cast<char*>(res.body.data()), res.body.size()); std::cout << text.substr(0, 120) << "...\n"; } catch (const std::exception& e) { std::cerr << "ERROR: " << e.what() << '\n'; } curl_global_cleanup(); }