C++使用libcurl轻松实现文件下载

2025-08-21 10:59 开发作者： xiaokang-coding

为什么选择libcurl？

在C++中实现HTTP下载，我们有很多选择：

socket编程：太底层，需要手动处理HTTP协议
第三方网络库：学习成本高，依赖复杂
libcurl：工业级标准，简单易用，几乎所有linux系统都预装

libcurl的优势：

久经考验：被Git用于HTTP操作，被php内置cURL扩展采用
功能强大：支持HTTP/HTTPS/FTP等20+协议
文档完善：官方文档详细，社区活跃
性能优秀：C语言实现，效率极高
跨平台：Windows/Linux/MACOS全支持

环境准备

Ubuntu/Debian系统

sudo apt-get update
sudo apt-get install libcurl4-openssl-dev

CentOS/RHEL系统

sudo yum install libcurl-devel
# 或者新版本使用
sudo dnf install libcurl-devel

验证安装

curl-config --version

如果显示版本号，说明安装成功！

第一个下载程序：HelloDownloader

我们从最简单的例子开始。创建文件 hello_downloader.cpp：

#include <IOStream>
#include <fstream>
#include <curl/curl.h>

// 数据写入回调函数
size_t writeData(void* ptr, size_t size, size_t nmemb, FILE* stream) {
    size_t written = fwrite(ptr, size, nmemb, stream);
    return written;
}

int main() {
    CURL* curl;
    FILE* fp;
    CURLcode res;
    
    // 下载链接（这是一个测试文件）
    const char* url = "https://httpbin.org/json";
    const char* outfilename = "test.json";
    
    // 全局初始化curl
    curl_global_init(CURL_GLOBAL_DEFAULT);
    
    // 创建curl句柄
    curl = curl_easy_init();
    if(curl) {
        // 打开本地文件准备写入
        fp = fopen(outfilename, "wb");
        if(!fp) {
            std::cerr << "无法创建文件！" << std::endl;
            curl_easy_cleanup(curl);
            curl_global_cleanup();
            return 1;
        }
        
        // 设置URL
        curl_easy_setopt(curl, CURLOPT_URL, url);
        
        // 设置写入回调函数
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeData);
        
        // 设置写入文件指针
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
        
        // 跟随重定向
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        
        // 执行下载
        res = curl_easy_perform(curl);
        
        // 检查结果
        if(res != CURLE_OK) {
       js     std::cerr << "下载失败: " << curl_easy_strerror(res) << std::endl;
        } else {
            std::cout << "下载成功！文件保存为: " << outfilename << std::endl;
        }
        
        // 清理
        fclose(fp);
        curl_easy_cleanup(curl);
    }
    
    curl_global_cleanup();
    return 0;
}

编译运行：

g++ -o hello_downloader hello_downloader.cpp -lcurl
./hello_downloader

如果一切正常，你会看到：

下载成功！文件保存为: test.json

恭喜！你的第一个C++下载器诞生了！

进阶版本：带进度显示的下载器

基础版本太朴素？来个炫酷的进度条版本！

#include <iostream>
#include <fstream>
#include <iomanip>
#include <curl/curl.h>

// 进度回调函数
int progressCallback(void* ptr, double totalToDownload, double nowDownloaded, 
                    double totalToUpload, double nowUploaded) {
    if (totalToDownload <= 0.0) return 0;
    
    double percentage = (nowDownloaded / totalToDownload) * 100.0;
    int barWidth = 50;
    int pos = static_cast<int>(barWidth * percentage / 100.0);
    
    std::cout << "\r[";
    for (int i = 0; i < barWidth; ++i) {
        if (i < pos) std::cout << "=";
        else if (i == pos) std::cout << ">";
        else std::cout << " ";
    }
    std::cout << "] " << std::fixed << std::setprecision(1) << percentage << "%";
    std::cout << " (" << static_cast<long>(nowDownloaded) << "/" 
              << static_cast<long>(totalToDownload) << " bytes)";
    std::cout.flush();
    
    return 0;
}

// 写入数据回调
size_t writeData(void* ptr, size_t size, size_t nmemb, FILE* stream) {
    return fwrite(ptr, size, nmemb, stream);
}

class SimpleDownloader php{
private:
    CURL* curl;
    
public:
    SimpleDownloader() {
        curl_global_init(CURL_GLOBAL_DEFAULT);
        curl = curl_easy_init();
    }
    
    ~SimpleDownloader() {
        if (curl) {
            curl_easy_cleanup(curl);
        }
        curl_global_cleanup();
    }
    
    bool download(const std::sjavascripttring& url, const std::string& filename) {
        if (!curl) return false;
        
        FILE* fp = fopen(filename.c_str(), "wb");
        if (!fp) {
            std::cerr << "无法创建文件: " << filename << std::endl;
            return false;
        }
        
        // 基本设置
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeData);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        
        // 进度显示设置
        curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 0L);
        curl_easy_setopt(curl, CURLOPT_PROGRESSFUNCTION, progressCallback);
        
        // 用户代理（有些网站需要）
        curl_easy_setopt(curl, CURLOPT_USERAGENT, "SimpleDownloader/1.0");
        
        // 超时设置
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 300L);  // 5分钟超时
        curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 30L);  // 连接30秒超时
        
        std::cout << "开始下载: " << url << std::endl;
        CURLcode res = curl_easy_perform(curl);
        std::cout << std::endl;  // 换行
        
        fclose(fp);
        
        if (res != CURLE_OK) {
            std::cerr << "下载失败: " << curl_easy_strerror(res) << std::endl;
            return false;
        }
        
        std::cout << "下载完成！文件保存为: " << filename << std::endl;
        return true;
    }
};

int main() {
    SimpleDownloader downloader;
    
    // 你可以替换成任何你想下载的文件
    std::string url = "https://httpbin.org/json";
    std::string filename = "downloaded_file.json";
    
    if (downloader.download(url, filename)) {
        std::cout << "下载成功！" << std::endl;
    } else {
        std::cout << "下载失败！" << std::endl;
    }
    
    return 0;
}

编译运行：

g++ -o progress_downloader progress_downloader.cpp -lcurl
./progress_downloader

你会看到类似这样的效果：

开始下载: https://httpbin.org/json
[==================================================] 100.0http://www.devze.com% (429/429 bytes)

核心概念详解

1. CURL句柄管理

// 全局初始化（程序启动时调用一次）
curl_global_init(CURL_GLOBAL_DEFAULT);

// 创建会话句柄
CURL* curl = curl_easy_init();

// 使用完毕后清理
curl_easy_cleanup(curl);
curl_global_cleanup();

2. 关键选项设置

// 基础设置
curl_easy_setopt(curl, CURLOPT_URL, url);                    // 设置URL
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);          // 跟随重定向
curl_easy_setopt(curl, CURLOPT_USERAGENT, "MyApp/1.0");      // 用户代理

// 超时控制
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 300L);               // 总超时时间
curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 30L);         // 连接超时

// SSL设置（HTTPS需要）
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);          // 验证证书
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 2L);          // 验证主机名

3. 回调函数机制

libcurl通过回调函数处理数据：

// 数据接收回调
size_t writeCallback(void* contents, size_t size, size_t nmemb, void* userp) {
    size_t realsize = size * nmemb;
    // 处理接收到的数据
    return realsize;  // 返回处理的字节数
}

// 进度回调
int progressCallback(void* clientp, double dltotal, double dlnow, 
                    double ultotal, double ulnow) {
    // 显示进度信息
    return 0;  // 返回0继续，非0中止
}

常见问题与解决方案

问题1：编译时找不到curl.h

解决方案：

# 检查是否安装开发包
dpkg -l | grep curl
# 如果没有，重新安装
sudo apt-get install libcurl4-openssl-dev

问题2：下载HTTPS链接失败

解决方案：

// 添加SSL设置
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 2L);
curl_easy_setopt(curl, CURLOPT_CAINFO, "/etc/ssl/certs/ca-certificates.crt");

问题3：某些网站返回403错误

解决方案：

// 设置更真实的用户代理
curl_easy_setopt(curl, CURLOPT_USERAGENT, 
    "Mozilla/5.0 (Linux; x86_64) AppleWebKit/537.36");

// 添加请求头
struct curl_slist* headers = NULL;
headers = curl_slist_append(headers, "Accept: */*");
headers = curl_slist_append(headers, "Accept-Encoding: gzip, deflate");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

性能优化小贴士

1. 启用压缩

curl_easy_setopt(curl, CURLOPT_ACpythonCEPT_ENCODING, "");  // 自动处理所有支持的编码

2. 复用连接

curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L);
curl_easy_setopt(curl, CURLOPT_TCP_KEEPIDLE, 120L);
curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L);

3. 设置合适的缓冲区

curl_easy_setopt(curl, CURLOPT_BUFFERSIZE, 102400L);  // 100KB缓冲区

总结

通过这篇教程，我们学会了：

libcurl环境搭建：快速安装和配置
基础下载实现：从最简单的 demo 开始
进阶功能添加：进度显示、错误处理、超时控制
面向对象封装：用类封装提高代码复用性
常见问题解决：实际开发中的坑点和解决方案

现在你已经掌握了C++单线程下载的核心技术！

但是，单线程下载在面对大文件时还是太慢了。试想一下：

下载几GB的文件需要等很久
网络中断后又要重新开始
....

如果能实现多线程并发下载，速度提升10倍以上，那该多爽！

到此这篇关于C++使用libcurl轻松实现文件下载的文章就介绍到这了,更多相关C++ libcurl文件下载内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)！

继续阅读：C++ libcurl C++ libcurl实现文件下载 C++文件下载

C++使用libcurl轻松实现文件下载

目录

为什么选择libcurl？

环境准备

Ubuntu/Debian系统

CentOS/RHEL系统

验证安装

第一个下载程序：HelloDownloader

进阶版本：带进度显示的下载器

核心概念详解

1. CURL句柄管理

2. 关键选项设置

3. 回调函数机制

常见问题与解决方案

问题1：编译时找不到curl.h

问题2：下载HTTPS链接失败

问题3：某些网站返回403错误

性能优化小贴士

1. 启用压缩

2. 复用连接

3. 设置合适的缓冲区

总结

更多精彩内容

精彩评论

最新开发

Spring MVC处理HTTP状态码、响应头和异常的完整示例

QT Creator配置Kit的实现示例

C#下Newtonsoft.Json的具体使用

Python PDF识别之文本内容与表格提取方法总结

C#实现Excel转为CSV的高效解决方案

开发排行榜

springboot后端存储富文本内容的思路与步骤(含图片内容)

PyCharm运行python测试,报错“没有发现测试”/“空套件”的解决

return base64.b64encode(b).decode(

基于C语言实现钻石棋游戏的示例代码

Sublime Text 3解决中文乱码问题（实测可用）