C++如何使用OpenXLSX操作Excel-C++-PHP中文网

openxlsx仅支持.xlsx格式，不支持.xls；依赖xlnt和zlib，需正确链接；写入中文须显式设置系统已安装的中文字体；读大文件应跳过样式或流式解析以避免oom。

c++如何使用openxlsx操作excel

OpenXLSX 不能直接操作 Excel 的 .xls 文件

OpenXLSX 只支持读写 .xlsx（Office Open XML 格式），完全不支持老式 .xls（二进制 BIFF 格式）。如果你拿到的是 .xls 文件，用 OpenXLSX 打开会静默失败或抛出 xlnt::invalid_file_format 类似的错误——它底层依赖的是 xlnt 的解析器，而 xlnt 从不处理 BIFF。

实操建议：

先用文件命令确认格式：file yourfile.xls，若输出含 Composite Document File V2，就是真 .xls，必须转格式
用 LibreOffice 命令行批量转换：soffice --headless --convert-to xlsx input.xls
别尝试用 OpenXLSX + libxls 混合桥接——没有官方支持，内存模型和异常传播都不兼容

链接 OpenXLSX 需要同时处理 xlnt 和 zlib

OpenXLSX 是头文件库，但运行时强依赖 xlnt（它自己的 Excel 解析子库）和 zlib（解压/压缩 ZIP 容器）。CMakeLists.txt 里漏掉任一依赖，编译能过，但链接阶段会报一堆未定义引用，比如：

undefined reference to `xlnt::workbook::workbook()'
undefined reference to `uncompress'

常见疏漏点：

只 find_package(OpenXLSX)，没 find_package(xlnt) 和 find_package(ZLIB)
链接时只加 OpenXLSX::OpenXLSX，漏了 xlnt::xlnt 和 ZLIB::ZLIB
Windows 下用 MSVC + vcpkg 安装时，默认不编译 xlnt 的 shared 版本，得加 vcpkg install xlnt:x64-windows-static 并确保 OpenXLSX 编译选项匹配

写入中文内容必须显式设置字体和编码

OpenXLSX 默认使用 Calibri 字体，该字体在多数 Linux/macOS 系统中不含中文 glyph，单元格看似写了字符串，实际 Excel 打开显示为空白或方块。这不是乱码，是字体缺失导致的渲染失败。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

解决方式不是改 locale 或宽字符转换，而是直接嵌入字体声明：

auto wb = xlnt::workbook();
auto ws = wb.create_sheet("Sheet1");
ws.cell("A1").value("你好世界");
ws.cell("A1").font().name("SimSun"); // Windows
// 或 ws.cell("A1").font().name("Noto Sans CJK SC"); // Linux/macOS
wb.save("output.xlsx");

注意：

font().name() 必须在 value() 之后调用，顺序反了无效
字体名必须是系统已安装字体的精确名称（区分空格、大小写），可用 fc-list :lang=zh 查 Linux 字体
不设置字体时，ws.cell("A1").value(L"你好") 用宽字符串也没用——OpenXLSX 内部只存 UTF-8 string_view

读取大文件时避免全量加载到内存

OpenXLSX 默认把整个 .xlsx 解压并解析成 DOM 树，10MB 文件可能吃掉 300MB 内存。对日志导出、报表生成等场景极易 OOM。

可行的轻量读法：

用 xlnt::workbook::load() 后立刻调用 ws.rows() 迭代，别缓存所有 cell 对象
禁用样式解析：xlnt::workbook wb; wb.load("big.xlsx", xlnt::load_options::skip_styles);
如果只需某几列，手动解析 [Content_Types].xml 和 xl/worksheets/sheet1.xml（ZIP 内路径），用 tinyxml2 流式读——OpenXLSX 不提供 SAX 接口，这是唯一绕过内存爆炸的办法

真正麻烦的从来不是 API 调用，而是你没意识到 .xlsx 本质是个 ZIP 包，而 OpenXLSX 把它当黑盒全吞了。