如果你在寻找一个无需复杂依赖、文档简洁且支持跨平台的 C++ HTTP 库，cpp-httplib 是理想选择。作为单头文件轻量级库，它封装了 HTTP 客户端和服务器的核心功能，适合快速开发小型 Web 服务或 API 调用工具。
一、先搞懂：cpp-httplib 到底好在哪？
- 真正的'零依赖'：整个库仅一个
httplib.h头文件，无需安装 Boost 或 curl，拷贝到项目后#include即可使用。 - 跨平台无压力：支持 Windows（MinGW/MSVC）、Linux、macOS，编译参数调整即可适配不同系统。
- 同步/异步都支持：简单场景用同步调用，高并发场景可用异步操作，内置线程池管理。
- HTTP/1.1 特性完善：支持持久连接、管道化及
multipart/form-data文件上传。 - HTTPS/WSS 支持：对接 OpenSSL 或 mbedTLS 后可运行 HTTPS，编译时添加链接参数即可。
- API 设计直观：如服务器注册 GET 接口用
Server::Get()，客户端发 POST 请求用Client::Post()。
二、5 分钟搞定安装：就一行克隆命令
cpp-httplib 无需复杂的配置流程，直接从 GitHub 拉取源码即可。
1. 克隆源码到本地
打开终端执行以下命令：
git clone https://github.com/yhirose/cpp-httplib.git
拉完后，cpp-httplib 目录下包含核心头文件 httplib.h。
2. 项目中引用头文件
无需将库安装到系统目录，直接在代码中指定路径：
- 若将
cpp-httplib目录与代码文件放同级：
#include "cpp-httplib/httplib.h"
- 若只拷贝
httplib.h到代码目录：
#include "httplib.h"
三、核心类与接口：搞懂这 4 个就够了
cpp-httplib 的核心逻辑围绕 Request、Response、Server、Client 四个关键结构展开。
1. Request：解析客户端发来的请求
| 成员 | 作用说明 | 示例 |
|---|---|---|
method | 请求方法（GET/POST/PUT/DELETE） | req.method == "GET" |
path | 请求路径 |
