C++如何实现一个简单的HTTP客户端？libcurl在C++中的使用教程【网络库】-C++-PHP中文网

C++如何实现一个简单的HTTP客户端？libcurl在C++中的使用教程【网络库】

冰火之心

发布： 2025-12-13 22:48:07

原创

967人浏览过

最实用、跨平台、稳定的C++ HTTP客户端方案是使用libcurl。它提供简洁C接口，支持GET/POST等请求，需正确处理回调、错误检查、资源释放及HTTPS证书验证等细节。

c++如何实现一个简单的http客户端？libcurl在c++中的使用教程【网络库】

用 C++ 写一个简单的 HTTP 客户端，最实用、跨平台、稳定的方式就是用 libcurl。它不是 C++ 原生库，但封装良好，C 接口也能自然融入 C++ 项目，无需额外绑定或复杂构建。

安装与基础链接

Linux（如 Ubuntu）直接装开发包：

sudo apt install libcurl4-openssl-dev

macOS 用 Homebrew：

brew install curl（头文件和库默认可用）

Windows 推荐用 vcpkg 或预编译二进制，链接时加 -lcurl（GCC/Clang）或链接 curldll.lib（MSVC）。

立即学习“C++免费学习笔记（深入）”；

拾贝

一键同步微信读书所有笔记和划线，并在新标签页回顾

186

查看详情

发起一次 GET 请求（最简示例）

核心是初始化句柄、设置选项、执行、清理。下面是一个不带错误检查但逻辑清晰的 GET 示例：

#include <iostream>
#include <string>
#include <curl/curl.h>
<p>size_t WriteCallback(void<em> contents, size_t size, size_t nmemb, void</em> userp) {
size_t realsize = size <em> nmemb;
std::string</em> buf = static_cast<std::string<em>>(userp);
buf->append(static_cast<char</em>>(contents), realsize);
return realsize;
}</p><p>int main() {
CURL* curl;
CURLcode res;
std::string response;</p><pre class="brush:php;toolbar:false;">curl = curl_easy_init();
if (!curl) return 1;

curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/get");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L); // 自动跳转

res = curl_easy_perform(curl);
if (res == CURLE_OK) {
    std::cout << "Response:\n" << response << std::endl;
} else {
    std::cerr << "curl error: " << curl_easy_strerror(res) << std::endl;
}

curl_easy_cleanup(curl);
return 0;

登录后复制

}

发送 POST 请求（带 JSON 数据）

关键在设置请求方法、请求体、Content-Type 头：

用 CURLOPT_POST 或 CURLOPT_CUSTOMREQUEST 控制方法
用 CURLOPT_POSTFIELDS 传原始字节（适合 JSON 字符串）
用 CURLOPT_HTTPHEADER 添加 Content-Type: application/json

示例片段：

std::string json = R"({"name":"Alice","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/dc076eb055ef5f8a60a41b6195e9f329">https://www.php.cn/link/dc076eb055ef5f8a60a41b6195e9f329</a>");
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json.c_str());
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
// ... 执行 & 清理
curl_slist_free_all(headers); // 别忘了释放 header 链表

登录后复制

常见注意事项

每次 curl_easy_init() 对应一次独立请求；高频场景建议复用句柄（调用 curl_easy_reset() 重置）
回调函数必须是 C 风格（不能是成员函数），如需访问对象状态，用 CURLOPT_WRITEDATA 传 this 指针或智能指针
HTTPS 默认校验证书；若测试时想跳过（仅限开发），加 CURLOPT_SSL_VERIFYPEER, 0L 和 CURLOPT_SSL_VERIFYHOST, 0L（生产环境禁用！）
超时控制推荐设 CURLOPT_TIMEOUT（单位秒）和 CURLOPT_CONNECTTIMEOUT