cpprestsdk是微软开源的跨平台C++ HTTP库，支持异步客户端与服务端开发；需通过vcpkg安装并链接cpprest，Windows用WinHTTP、Linux/macOS依赖libcurl；客户端用http_client发请求，服务端用http_listener监听路由。
cpprestsdk（也叫Casablanca）是微软开源的C++ HTTP库，支持跨平台异步HTTP客户端和服务端开发。它基于现代C++11+特性，封装了底层网络细节，适合需要高性能、可移植HTTP能力的C++项目。
安装与环境准备
官方推荐通过vcpkg安装，最简单可靠：
- Windows：运行
vcpkg install cpprestsdk:x64-windows，再在CMake中启用vcpkg_toolchain_file - Linux/macOS：用vcpkg或源码编译（需CMake 3.12+、Boost、OpenSSL、Zlib等依赖）
- CMake中链接时需添加：
target_link_libraries(your_target PRIVATE cpprest)
注意：Windows下默认使用WinHTTP；Linux/macOS依赖libcurl，确保系统已安装libcurl4-openssl-dev（Ubuntu）或对应包。
HTTP客户端：发送GET/POST请求
核心类是http_client，配合http_request和http_response完成异步交互：
立即学习“C++免费学习笔记（深入）”；
- 发起GET请求：
client.request(methods::GET, L"/api/data").then([](http_response res) { return res.extract_string(); }).wait(); - 带JSON的POST请求：构造
json::value，调用req.set_body(json_val); req.set_method(methods::POST); - 设置Header：用
req.headers().add(L"Content-Type", L"application/json"); - 错误处理必须检查
res.status_code()，不能只靠异常——网络超时、重定向、服务端5xx都可能返回成功task但状态码异常
HTTP服务端：快速启动REST接口
用http_listener监听路径，注册处理函数：
- 初始化监听器：
http_listener listener(U("http://localhost:34567/api")); listener.support(methods::GET, handle_get); - GET处理示例：提取查询参数用
uri::split_query(req.request_uri().query())，返回JSON用res.set_body(json::value::object().set(U("msg"), U("ok"))) - POST解析JSON体：
req.extract_json().then([](json::value j) { /* 处理j */ }) - 启动监听：
listener.open().wait();，关闭用listener.close().wait();
注意：服务端不内置路由匹配，复杂路径需手动解析request_uri().path()，建议搭配轻量级路由封装（如自定义map映射路径到handler）。
常见问题与避坑提示
实际开发中容易卡住的点：
- 中文路径或参数必须URL编码，用
uri::encode_uri()，否则http_listener可能解析失败 - 异步链中不要裸写
.wait()在UI线程（如Win32消息循环），会阻塞；优先用.then()延续，或改用create_task包装 - JSON中文字符串要确保UTF-8编码，
json::value::string(U"你好")自动转为UTF-8字节流，无需额外处理 - 服务端无法绑定0.0.0.0？检查防火墙或是否被占用；本地测试建议先用
127.0.0.1
不复杂但容易忽略细节，把基础请求/响应流程跑通后，再逐步加认证、日志、连接池等扩展功能更稳妥。
