最直接方式是调用curl_easy_setopt(curl, curlopt_useragent, "myapp/2.1.0")，需在curl_easy_perform前设置，传入c风格字符串，多次设置后一次覆盖前一次。
用 libcurl 设置 User-Agent 最直接的方式
libcurl 是 C++ 里最常用的 HTTP 客户端库，curl_easy_setopt 配合 CURLOPT_USERAGENT 就能完成设置。关键不是“能不能”，而是参数传什么、什么时候传、是否会被覆盖。
- 必须在
curl_easy_perform调用前设置，之后再设无效 -
CURLOPT_USERAGENT接收的是const char*，传入字符串字面量或以\0结尾的缓冲区均可 - 如果没显式设置，libcurl 默认会发
User-Agent: curl/<version></version>，某些 API 会拒绝这类请求 - 多次调用
curl_easy_setopt同一选项，后一次会覆盖前一次
CURL* curl = curl_easy_init();
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://api.example.com/data");
curl_easy_setopt(curl, CURLOPT_USERAGENT, "MyApp/2.1.0 (Linux; x86_64)");
curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
用 Boost.Beast 手动构造请求头
Boost.Beast 不像 libcurl 那样封装好高层选项，User-Agent 得自己加进 http::request 的字段里。好处是完全可控，坏处是容易漏掉冒号后的空格或换行格式。
-
User-Agent是标准 HTTP 请求头字段，必须按field: value格式添加 - 使用
req.set(http::field::user_agent, "MyClient/1.0")最安全，http::field::user_agent已预定义字段名和大小写规范 - 如果手动用
req.insert("User-Agent", "...")，注意字段名大小写不敏感但建议首字母大写，值不能含回车换行 - 没有设置时，Beast 发出的请求默认不带
User-Agent字段，部分服务端会直接 403
Qt 的 QNetworkRequest 怎么设
Qt 提供了更高层的抽象，QNetworkRequest 通过 setRawHeader 添加自定义头，User-Agent 属于常规头，但 Qt 不提供专用 setter，必须走通用接口。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须用
request.setRawHeader("User-Agent", "MyQtApp/0.9")，不能写成"user-agent"或"USER-AGENT"（虽然 HTTP 协议允许，但 Qt 内部匹配可能失败） -
setRawHeader会覆盖之前同名头，重复调用只保留最后一次 - 如果用
QNetworkAccessManager发起请求，且未设置User-Agent，Qt 默认不发送该字段，不是填空字符串 - 在
QNetworkReply的finished()信号回调里无法再修改请求头，只能重发
常见坑：被中间件或代理覆盖
有些环境（比如公司内网代理、某些测试框架、或自己写的 HTTP 中间层）会在转发请求时重写 User-Agent。你以为设了，抓包一看却是别的值，问题往往不在你代码里。
- 先用
tcpdump或 Wireshark 抓本地环回流量，确认发出的请求是否真含你设的值 - 如果用的是封装库（如 RESTinC++、cpp-httplib），查文档看它是否默认注入自己的
User-Agent，有的库会在你没设时自动补，有的则会强制覆盖 - 某些 Android NDK 或 iOS 的网络栈对
User-Agent有长度限制（如超 256 字节被截断），长版本号+括号描述容易踩中 - Windows 上若链接了旧版 WinHTTP，
User-Agent可能被系统策略静默替换，得换用 WinINet 或第三方库
实际调试时，别只信日志输出，一定要看真实 wire 数据。字段看着设上了，不代表它最终出现在 TCP payload 里。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
