c++ 无法直接生成 pdf，必须依赖第三方库或外部工具；推荐 libharu（轻量、纯 c、mit 许可）或调用 wkhtmltopdf；需重点处理中文、字体、路径和错误检查。
用 C++ 直接生成 PDF 没有标准库支持，必须依赖第三方库
标准 C++ 不提供 PDF 生成能力，std::ofstream 只能写二进制或文本，但 PDF 是结构化二进制格式（含对象流、交叉引用表、压缩字典等），手写极易出错。硬编码 PDF 字节流仅适合极简单页测试，生产环境不可行。
实际可行路径只有两条：调用外部命令行工具（如 wkhtmltopdf），或集成成熟 C++ PDF 库。前者依赖系统环境，后者更可控但需编译链接。
推荐首选：libharu（轻量、纯 C、无依赖、MIT 许可）
libharu 是少数专注 C/C++ 的成熟 PDF 库，不依赖 Qt 或 Boost，编译简单，适合嵌入式或 CLI 工具场景。缺点是停止维护（最新版 2012 年），但基础功能（文字、线条、表格、PNG/JPEG 嵌入）稳定可靠。
- 编译时需启用
HPDF_ENABLE_JPEG才能插入 JPEG 图片 -
HPDF_Page_BeginText后必须配对调用HPDF_Page_EndText，否则文字不渲染 - 中文需先加载 TrueType 字体（如
HPDF_LoadTTFontFromFile），且字体文件路径不能含空格或 Unicode 路径（Windows 下易踩坑） - 页边距、坐标原点在左下角（非左上角），
HPDF_Page_MoveTo的 y 值要按页面高度减去预期位置
替代方案：用 C++ 调用 wkhtmltopdf 生成 HTML 再转 PDF
适合已有 HTML 报告模板的项目，规避 PDF 布局复杂度。本质是进程通信，不是“C++ 生成 PDF”，但实操中更鲁棒。
- 调用方式：用
std::system或posix_spawn（Linux/macOS）、CreateProcess（Windows）执行wkhtmltopdf input.html output.pdf - HTML 中避免使用
flex或grid布局——wkhtmltopdf 基于旧版 WebKit，CSS 支持有限 - 字体需内联或转 base64，否则生成 PDF 时可能丢失（尤其 Windows 上中文字体路径解析失败）
- 超时控制很重要：
wkhtmltopdf渲染卡住时会阻塞进程，建议加timeout命令（Linux/macOS）或手动实现等待逻辑
避坑重点：中文、字体、路径、错误检查
90% 的 C++ PDF 生成失败都集中在这四点，不是代码逻辑问题，而是环境和配置细节。
- libharu 加载中文字体失败时，
HPDF_GetError返回HPDF_INVALID_FONT，但不会崩溃——必须主动检查返回值，否则后续HPDF_Page_SetFontAndSize无效 - Windows 下绝对路径要用双反斜杠或正斜杠，如
"C:/fonts/simhei.ttf"，单反斜杠会被当转义符处理 - PDF 文件写入后务必调用
HPDF_SaveToFile，仅HPDF_Free不会落盘 - 若报告含图表，优先导出为 PNG（而非 SVG），libharu 不支持矢量图嵌入
真正麻烦的从来不是“怎么写第一行 PDF 代码”，而是让中文字体在客户机器上正确显示、让图片尺寸不被拉伸、让生成的 PDF 能被 Adobe Reader 正常打开——这些都得靠反复试错和细粒度错误检查。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
