在C++开发中，实现HTTP客户端功能如果完全从零手写TCP连接和HTTP协议解析，会耗费大量时间且容易引入兼容性问题。libcurl作为一款跨平台的开源网络库，已经封装了各类网络协议的底层实现，开发者只需要调用其提供的API就能快速完成HTTP请求的发送和响应处理，非常适合在C++项目中快速搭建HTTP客户端。
环境准备
在使用libcurl之前，需要先完成库的安装和项目配置。不同平台的安装方式略有区别：
- Linux系统可以通过包管理器直接安装，比如Ubuntu执行
sudo apt-get install libcurl4-openssl-dev - Windows系统可以从libcurl官网下载编译好的二进制包，或者在项目中通过vcpkg等包管理工具引入
- macOS系统可以使用homebrew执行
brew install curl完成安装
项目编译时需要链接libcurl库，比如使用g++编译时添加-lcurl参数。
libcurl核心使用流程
使用libcurl发送HTTP请求的核心流程可以分为四步：
- 初始化libcurl全局环境
- 创建并配置curl句柄
- 执行请求并处理响应
- 清理资源，释放全局环境
基础GET请求实现
下面的代码演示了使用libcurl发送GET请求并获取响应内容的基本实现：
#include <iostream>
#include <curl/curl.h>
#include <string>
// 响应数据回调函数，用于将接收到的数据拼接到字符串中
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
size_t totalSize = size * nmemb;
userp->append((char*)contents, totalSize);
return totalSize;
}
int main() {
// 初始化libcurl全局环境
CURLcode globalInitCode = curl_global_init(CURL_GLOBAL_DEFAULT);
if (globalInitCode != CURLE_OK) {
std::cerr << "curl全局初始化失败: " << curl_easy_strerror(globalInitCode) << std::endl;
return 1;
}
// 创建curl句柄
CURL* curl = curl_easy_init();
if (!curl) {
std::cerr << "创建curl句柄失败" << std::endl;
curl_global_cleanup();
return 1;
}
std::string responseData;
// 设置请求的URL
curl_easy_setopt(curl, CURLOPT_URL, "http://ipipp.com/api/test");
// 设置接收数据的回调函数
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
// 设置回调函数的用户参数，用于传递存储响应数据的字符串
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &responseData);
// 设置超时时间，单位秒
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
// 执行请求
CURLcode res = curl_easy_perform(curl);
if (res != CURLE_OK) {
std::cerr << "请求执行失败: " << curl_easy_strerror(res) << std::endl;
} else {
// 获取HTTP响应状态码
long httpCode = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &httpCode);
std::cout << "HTTP响应状态码: " << httpCode << std::endl;
std::cout << "响应内容: " << responseData << std::endl;
}
// 清理curl句柄
curl_easy_cleanup(curl);
// 清理全局环境
curl_global_cleanup();
return 0;
}
POST请求实现
发送POST请求时只需要额外设置请求方法和请求体内容即可，下面是实现POST请求的示例代码：
#include <iostream>
#include <curl/curl.h>
#include <string>
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
size_t totalSize = size * nmemb;
userp->append((char*)contents, totalSize);
return totalSize;
}
int main() {
curl_global_init(CURL_GLOBAL_DEFAULT);
CURL* curl = curl_easy_init();
if (!curl) {
std::cerr << "创建curl句柄失败" << std::endl;
return 1;
}
std::string responseData;
// 设置POST请求的URL
curl_easy_setopt(curl, CURLOPT_URL, "http://ipipp.com/api/post_test");
// 设置POST请求体内容，这里以JSON格式为例
std::string postData = "{"name":"test","age":20}";
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
// 添加自定义请求头，指定内容类型为JSON
struct curl_slist* headers = nullptr;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
// 设置响应回调
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &responseData);
// 设置超时时间
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
CURLcode res = curl_easy_perform(curl);
if (res != CURLE_OK) {
std::cerr << "POST请求失败: " << curl_easy_strerror(res) << std::endl;
} else {
long httpCode = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &httpCode);
std::cout << "HTTP响应状态码: " << httpCode << std::endl;
std::cout << "响应内容: " << responseData << std::endl;
}
// 释放请求头链表
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
curl_global_cleanup();
return 0;
}
常见问题说明
在实际使用libcurl时，有几个需要注意的点：
- 如果请求HTTPS地址，需要确保libcurl编译时开启了SSL支持，否则会返回协议不支持的错误
- 回调函数中不要做耗时操作，否则会阻塞请求执行流程
- 所有curl_easy_setopt设置的选项都是针对当前句柄的，多个请求需要创建多个句柄或者复用句柄时重置配置
- 项目发布时需要确保目标机器上存在libcurl的动态库，或者将libcurl编译为静态库集成到项目中
C++libcurlHTTP_client网络库修改时间：2026-07-11 22:09:24