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></xlsxwriter.h>，不用 STL 封装，所有 API 都是 C 风格指针操作
lxw_workbook 和 lxw_worksheet 怎么配对使用
和 Excel 界面逻辑一致：一个文件对应一个 lxw_workbook，一个 sheet 对应一个 lxw_worksheet。但注意，workbook 必须最后调用 lxw_workbook_close() 才会真正写盘；中途任何未 close 就退出，文件就是空的或损坏的。
典型流程：
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
<p>常见错误：<code>worksheet_write_*</code> 系列函数行列参数顺序是 <code>(row, col)</code>，不是 <code>(col, row)</code>，反了就写飞。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<h3>中文乱码？必须显式设置字体</h3>
<p><code>libxlsxwriter</code> 默认用 Calibri 字体，Windows 上显示中文可能方块，macOS/Linux 更大概率空白。解决办法不是改系统字体，而是在创建 workbook 时指定支持 UTF-8 的字体：</p>
<pre class="brush:php;toolbar:false;">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，但反复生成文件会内存缓慢上涨。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
