libxlsxwriter 是纯 C 编写的跨平台、零依赖 .xlsx 写入库，只支持新建文件写入，不支持读取或修改；需调用 lxw_workbook_close() 才能生成完整文件。
用 libxlsxwriter 直接写入，不依赖 Excel 进程
Windows 上用 COM 自动化或 Linux 上调用 LibreOffice 导出，又慢又容易崩，还难部署。真正稳定、跨平台、零依赖的方案是直接生成 .xlsx 二进制文件——libxlsxwriter 就是干这事的。它纯 C 写成，C++ 可直接调用，不启动任何外部程序，写 10 万行数据也只占几 MB 内存。
关键点：libxlsxwriter 是只写（write-only）库，不能读、不能修改已有文件。如果你需要“查询后追加到现有表”，它做不到——得换 xlnt 或 cppxll。
- Windows 下推荐用 vcpkg 安装：
vcpkg install libxlsxwriter，然后链接libxlsxwriter.lib - Linux/macOS 用 cmake +
find_package(libxlsxwriter REQUIRED)，源码编译也只要make && sudo make install - 头文件就一个：
#include <xlsxwriter.h>，不用 STL 封装，所有 API 都是 C 风格指针操作
lxw_workbook 和 lxw_worksheet 怎么配对使用
和 Excel 界面逻辑一致：一个文件对应一个 lxw_workbook，一个 sheet 对应一个 lxw_worksheet。但注意，workbook 必须最后调用 lxw_workbook_close() 才会真正写盘；中途任何未 close 就退出，文件就是空的或损坏的。
典型流程：
立即学习“C++免费学习笔记（深入）”；
lxw_workbook *workbook = workbook_new("output.xlsx");
lxw_worksheet *worksheet = workbook_add_worksheet(workbook, NULL);
// 写表头（第 0 行）
worksheet_write_string(worksheet, 0, 0, "id", NULL);
worksheet_write_string(worksheet, 0, 1, "name", NULL);
worksheet_write_string(worksheet, 0, 2, "score", NULL);
// 写数据（从第 1 行开始）
for (size_t i = 0; i < results.size(); ++i) {
worksheet_write_number(worksheet, i+1, 0, results[i].id, NULL);
worksheet_write_string(worksheet, i+1, 1, results[i].name.c_str(), NULL);
worksheet_write_number(worksheet, i+1, 2, results[i].score, NULL);
}
workbook_close(workbook); // 必须调用！否则文件为空
常见错误：worksheet_write_* 系列函数行列参数顺序是 (row, col)，不是 (col, row)，反了就写飞。
中文乱码？必须显式设置字体
libxlsxwriter 默认用 Calibri 字体，Windows 上显示中文可能方块，macOS/Linux 更大概率空白。解决办法不是改系统字体，而是在创建 workbook 时指定支持 UTF-8 的字体：
lxw_workbook_options options = {.default_font = "Microsoft YaHei"};
lxw_workbook *workbook = workbook_new_opt("output.xlsx", &options);
注意两点：
-
default_font值必须是目标机器上实际安装的字体名（如 macOS 用"PingFang SC"，Linux 用"Noto Sans CJK SC"），不能写"SimSun"却没装 - 如果要单元格单独设字体（比如标题加粗），得用
lxw_format，且必须在workbook_add_format()后再传给worksheet_write_*()，不能复用已 close 的 workbook 的 format
查询结果含时间、布尔、公式？对应写入函数别混用
数据库查出来的字段类型和 Excel 单元格类型不一一对应，硬转会丢精度或报错。比如：
-
std::chrono::system_clock::time_point→ 先转成lxw_datetime结构（年月日时分秒毫秒字段拆开），再调用worksheet_write_datetime() -
bool→ 用worksheet_write_boolean()，别用write_number(1/0)，否则 Excel 里无法被筛选识别为逻辑值 - 想写公式（如
=SUM(C2:C100)）→ 用worksheet_write_formula()，字符串必须带等号，且函数名用英文，不支持中文函数名 - NULL 值 → 所有
write_*函数的最后一个参数是lxw_format *，传NULL即可，不要传空字符串或 0
性能提示：批量写数值时，worksheet_write_row() 比循环调用 write_number() 快 3–5 倍，但要求数据是连续 C 数组；STL vector 得先 .data() 提取指针。
最易被忽略的一点：libxlsxwriter 不做内存自动管理。所有 workbook、worksheet、format 对象都必须由你手动释放（其实 workbook_close() 内部已 free，但若中途出错没走到 close，就得自己 workbook_free()）。漏掉不会立刻 crash，但反复生成文件会内存缓慢上涨。
