遇到CURLE_COULDNT_RESOLVE_HOST需检查curl_global_init调用时机、/etc/resolv.conf可用性，或改用IP直连；大文件下载需设置WRITEFUNCTION回调避免内存暴涨；HTTPS报错应配置CAINFO或临时禁用证书验证；断点续传需结合RESUME_FROM与文件偏移管理。
curl_easy_perform 返回 CURLE_COULDNT_RESOLVE_HOST 怎么办
域名解析失败，大概率是没初始化 libcurl 的 DNS 缓存或系统配置异常。libcurl 默认用系统 resolver，但某些嵌入式环境或容器里 /etc/resolv.conf 缺失或不可读，就会卡在这儿。
- 调用
curl_global_init(CURL_GLOBAL_DEFAULT)必须在所有curl_easy_init()之前，且只调一次；漏掉或放错位置会导致 DNS 相关功能不可用 - 如果目标环境无 DNS（比如纯 IP 场景），直接用
http://192.168.1.100/file.zip替代域名，绕过解析 - 调试时加一句
curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L)，能看到具体哪步卡住，比猜快得多
下载大文件时进程卡死或内存暴涨
默认 libcurl 把整个响应体塞进内存再返回，遇到几百 MB 的文件，curl_easy_perform 不返回，malloc 却一直在涨。
- 必须设置回调函数接管数据流：用
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback)+CURLOPT_WRITEDATA指向FILE*或自定义缓冲区 - 别用
std::string拼接响应体——每次+=可能触发多次 realloc，改用固定大小 buffer（如 8KB）循环写入文件 - 记得在回调里返回实际写入字节数，返回值不匹配
size * nmemb会导致 libcurl 中断下载
HTTPS 下载报错 CURLE_SSL_CACERT 或证书验证失败
libcurl 编译时没绑定 CA 证书包，或运行时找不到 cert path，就会拒绝建立 HTTPS 连接。
- 最简方案：加
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L)和CURLOPT_SSL_VERIFYHOST, 0L（仅限测试/内网） - 生产环境应指定证书路径：
curl_easy_setopt(curl, CURLOPT_CAINFO, "/etc/ssl/certs/ca-certificates.crt")（Linux）或"ca-bundle.crt"（Windows） - 静态链接 libcurl 时，若用 MinGW 或 MSVC，需确认编译选项是否启用了 OpenSSL 支持；否则即使代码写了 SSL 设置，也会静默退化为 HTTP
如何让下载支持断点续传和进度回调
断点续传不是默认行为，得手动告诉 libcurl “从哪继续”，同时自己维护文件偏移和 Range 头。
立即学习“C++免费学习笔记（深入）”；
- 先用
fopen(filename, "ab")以追加模式打开文件，再用fseek(fp, 0, SEEK_END)获取已下载字节数resume_pos - 设置
curl_easy_setopt(curl, CURLOPT_RESUME_FROM, resume_pos)，libcurl 会自动加Range: bytes=xxx- - 进度回调用
CURLOPT_XFERINFOFUNCTION（推荐）而非旧的CURLOPT_PROGRESSFUNCTION，后者在多线程下可能不准；注意回调函数里不要做耗时操作，比如 printf
实际用起来，最难调的往往不是语法，而是网络状态变化时的重试逻辑、临时文件清理、以及 HTTPS 证书链和系统时间是否同步——这三个地方出问题，错误码看起来都像“连不上”，但原因天差地别。
