首先安装配置libcurl，然后使用其API初始化会话并发送HTTP请求。1. 通过curl_easy_init创建句柄，设置URL、回调函数和数据写入缓冲区实现GET请求。2. 发送POST请求时，使用CURLOPT_POSTFIELDS提交表单或JSON数据，并通过curl_slist_append添加Content-Type头部。3. 对于HTTPS，可临时禁用证书验证（仅测试），但生产环境应配置CA证书路径。4. 设置CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT避免超时问题，同时自定义请求头如Authorization和User-Agent。5. 始终检查返回码、清理资源以防止内存泄漏，最终完成安全稳定的HTTP通信。
在C++中实现HTTP客户端功能，libcurl 是最常用且跨平台的网络库之一。它支持多种协议（包括HTTP、HTTPS、FTP等），可用于发送GET、POST请求，处理请求头、表单数据、文件上传和SSL连接。本文将介绍如何使用 libcurl 在 C++ 中编写一个简单的 HTTP 客户端。
1. 安装和配置 libcurl
在开始编码前，需要确保系统中已安装 libcurl 开发库。
-
Ubuntu/Debian：运行
sudo apt-get install libcurl4-openssl-dev -
CentOS/RHEL：运行
sudo yum install curl-devel -
macOS：使用 Homebrew 安装：
brew install curl -
Windows：可通过 vcpkg 安装：
vcpkg install curl，或下载预编译版本并配置到项目中
编译时需链接 curl 库。例如使用 g++ 编译：
g++ main.cpp -lcurl -o http_client
2. 初始化和发送 GET 请求
最基本的用法是发送一个 HTTP GET 请求并获取响应内容。libcurl 使用回调函数接收服务器返回的数据。
立即学习“C++免费学习笔记（深入）”；
示例代码：
#include#include #include // 回调函数：用于接收响应数据 size_t WriteCallback(void contents, size_t size, size_t nmemb, std::string output) { size_t totalSize = size nmemb; output->append((char)contents, totalSize); return totalSize; }
int main() { CURL* curl; CURLcode res; std::string readBuffer;
curl = curl_easy_init(); if (curl) { curl_easy_setopt(curl, CURLOPT_URL, "http://httpbin.org/get"); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback); curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer); res = curl_easy_perform(curl); if (res != CURLE_OK) { std::cerr << "请求失败: " << curl_easy_strerror(res) << std::endl; } else { std::cout << "响应内容:\n" << readBuffer << std::endl; } curl_easy_cleanup(curl); } return 0;}
说明：
CURLOPT_WRITEFUNCTION设置数据写入回调函数CURLOPT_WRITEDATA指定用户数据指针（这里是字符串）- 回调函数每次接收到数据块都会被调用，需将其追加到缓冲区
3. 发送 POST 请求（表单和 JSON）
发送 POST 请求需要设置请求方法和数据体。
发送表单数据（application/x-www-form-urlencoded）：
curl_easy_setopt(curl, CURLOPT_URL, "https://www.php.cn/link/a51cc66bf971e1aaae696dfeb130f38b"); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "name=John&age=30"); res = curl_easy_perform(curl);发送 JSON 数据：
std::string jsonData = R"({"name": "John", "age": 30})"; struct curl_slist* headers = nullptr; headers = curl_slist_append(headers, "Content-Type: application/json");curl_easy_setopt(curl, CURLOPT_URL, "https://www.php.cn/link/a51cc66bf971e1aaae696dfeb130f38b"); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, jsonData.c_str()); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
res = curl_easy_perform(curl);
// 清理头部列表 curl_slist_free_all(headers);
4. 处理 HTTPS 和忽略证书验证（仅测试用）
如果访问 HTTPS 地址但遇到证书错误，可以临时关闭验证（不推荐用于生产环境）：
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); // 不验证证书 curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); // 不验证主机名建议在正式环境中保留验证，并设置 CA 证书路径：
curl_easy_setopt(curl, CURLOPT_CAINFO, "/path/to/cacert.pem");5. 设置超时和自定义请求头
避免请求长时间挂起，应设置超时时间：
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L); // 总超时（秒） curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 5L); // 连接超时添加自定义请求头：
struct curl_slist* headers = nullptr; headers = curl_slist_append(headers, "Authorization: Bearer token123"); headers = curl_slist_append(headers, "User-Agent: MyApp/1.0");curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
记得最后调用
curl_slist_free_all(headers)释放内存。基本上就这些。掌握以上内容后，你可以在 C++ 项目中灵活使用 libcurl 实现各类 HTTP 客户端功能。虽然 API 看似 C 风格，但在封装后可轻松集成到现代 C++ 架构中。注意始终检查返回值并妥善管理资源，避免内存泄漏。
