首先安装配置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 <iostream>
#include <string>
#include <curl/curl.h>
<p>// 回调函数：用于接收响应数据
size_t WriteCallback(void<em> contents, size_t size, size_t nmemb, std::string</em> output) {
size_t totalSize = size <em> nmemb;
output->append((char</em>)contents, totalSize);
return totalSize;
}</p><p>int main() {
CURL* curl;
CURLcode res;
std::string readBuffer;</p><pre class="brush:php;toolbar:false;">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）：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
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");
<p>curl_easy_setopt(curl, CURLOPT_URL, "<a href="https://www.php.cn/link/a51cc66bf971e1aaae696dfeb130f38b">https://www.php.cn/link/a51cc66bf971e1aaae696dfeb130f38b</a>");
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, jsonData.c_str());
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);</p><p>res = curl_easy_perform(curl);</p><p>// 清理头部列表
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"); <p>curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
记得最后调用 curl_slist_free_all(headers) 释放内存。
基本上就这些。掌握以上内容后，你可以在 C++ 项目中灵活使用 libcurl 实现各类 HTTP 客户端功能。虽然 API 看似 C 风格，但在封装后可轻松集成到现代 C++ 架构中。注意始终检查返回值并妥善管理资源，避免内存泄漏。
