如何正确使用curl_easy_escape()对含特殊字符的URL进行编码？

你遇到的问题核心是curl_easy_escape()是用来编码URL的组件片段，而非完整URL。当你把整个URL传入时，它会把协议部分的://也转成%3A%2F%2F，这会让curl无法识别主机名（因为原本的https://raw.githubusercontent.com变成了https%3A%2F%2Fraw.githubusercontent.com，服务器完全没法解析这个“主机名”），所以才会报Couldn't resolve host name错误。

正确的解决方案：使用curl的URL API（推荐） #

从curl 7.62.0版本开始，提供了专门的URL处理API（curl_url_*系列函数），它可以自动识别URL的各个组成部分（协议、主机、路径等），仅对需要编码的部分（比如路径里的空格）进行转义，完全不用手动拆分URL，完美适配复杂场景。

下面是代码示例：

#include <curl/curl.h>
#include <stdio.h>

int main() {
    CURLU *url = curl_url();
    char *output_url = NULL;
    CURLcode res;

    // 初始化curl环境
    curl_global_init(CURL_GLOBAL_DEFAULT);

    // 设置包含空格的原始URL
    res = curl_url_set(url, CURLUPART_URL, "https://raw.githubusercontent.com/HaaniPublish/MyPublish/master/8831fbc3-eec7-4caf-91ba-33543fa07456/Test data_v1.0.0.1.pff", 0);
    if(res != CURLUE_OK) {
        fprintf(stderr, "curl_url_set failed: %s\n", curl_url_strerror(res));
        goto cleanup;
    }

    // 获取自动编码后的正确URL
    res = curl_url_get(url, CURLUPART_URL, &output_url, 0);
    if(res != CURLUE_OK) {
        fprintf(stderr, "curl_url_get failed: %s\n", curl_url_strerror(res));
        goto cleanup;
    }

    printf("处理后的URL：%s\n", output_url);
    // 这里可直接将output_url传入curl_easy_perform()发起请求

cleanup:
    curl_free(output_url);
    curl_url_cleanup(url);
    curl_global_cleanup();
    return 0;
}

这段代码运行后，会输出你期望的结果：

https://raw.githubusercontent.com/HaaniPublish/MyPublish/master/8831fbc3-eec7-4caf-91ba-33543fa07456/Test%20data_v1.0.0.1.pff

兼容旧版本curl的方案（手动拆分编码） #

如果你使用的curl版本低于7.62.0，没法用URL API，那只能拆分URL的路径部分单独编码。虽然你提到拆分难度大，但可以通过字符串定位来简化操作：找到协议后第一个/的位置，将前面的协议+主机部分保留，后面的路径部分单独用curl_easy_escape()编码，再拼接起来。

示例代码（简化版）：

#include <curl/curl.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>

int main() {
    const char *original_url = "https://raw.githubusercontent.com/HaaniPublish/MyPublish/master/8831fbc3-eec7-4caf-91ba-33543fa07456/Test data_v1.0.0.1.pff";
    char *host_end = strstr(original_url, "://");
    if(!host_end) {
        fprintf(stderr, "Invalid URL format\n");
        return 1;
    }
    host_end += 3; // 跳过"://"
    char *path_start = strstr(host_end, "/");
    if(!path_start) {
        fprintf(stderr, "No path found in URL\n");
        return 1;
    }

    // 拆分协议+主机前缀
    size_t prefix_len = path_start - original_url;
    char *prefix = malloc(prefix_len + 1);
    strncpy(prefix, original_url, prefix_len);
    prefix[prefix_len] = '\0';

    // 编码路径部分
    CURL *curl = curl_easy_init();
    char *encoded_path = curl_easy_escape(curl, path_start, 0);

    // 拼接最终URL
    char *final_url = malloc(strlen(prefix) + strlen(encoded_path) + 1);
    strcpy(final_url, prefix);
    strcat(final_url, encoded_path);

    printf("最终URL：%s\n", final_url);

    // 清理资源
    curl_free(encoded_path);
    curl_easy_cleanup(curl);
    free(prefix);
    free(final_url);
    return 0;
}

不过这个方法对带查询参数、锚点的复杂URL需要额外适配，所以还是优先推荐使用curl的URL API，它能自动处理所有URL组件的编码规则，省心又可靠。

内容的提问来源于stack exchange，提问作者Eby