数据分析【免费下载链接】QXlsxExcel file(*.xlsx) reader/writer library using Qt. Descendant of QtXlsxWriter.项目地址https://gitcode.com/gh_mirrors/qx/QXlsx点击查看免费下载QXlsx 是一个基于 Qt 框架、使用 C 开发的 Excel 文件*.xlsx读取/写入库可直接以源码形式集成进 Qt 项目无需链接额外的动态库或静态库也可作为静态库使用。本文以仓库根目录的 README.zh-CN.md 为主体脉络完整讲解其项目定位、qmake 与 CMake 两种安装配置方式、HelloWorld 读写示例并结合作者仓库中的 Example.md、HowToSetProject.zh-CN.md、HowToSetProject-cmake.md 及核心源码深入剖析Document类的关键接口与典型应用。读完本文你将能够独立完成 QXlsx 的集成、配置并写出可运行的读写、格式、图表、SAX 流式解析等实战代码。1. 项目概述QXlsx 是什么根据 README.zh-CN.md 的定位QXlsx 是 Excel 文件*.xlsx的读取/写入库是 QtXlsxWriter 不再维护后、于 2017 年起基于 QtXlsx 衍生的新项目开发语言为 C结合 Qt 框架使用无需依赖额外的静态库或动态库即可直接集成到项目中也可以将整个 QXlsx 编译为静态库使用项目遵循 MIT 许可证。从仓库目录结构可以印证这一点核心库代码全部集中在 QXlsx/ 目录下包含 header/公开头文件与*_p.h私有实现头文件和 source/34 个.cpp源文件两个子目录并提供了 QXlsx.priqmake 集成文件、QXlsx.proqmake 工程文件与 CMakeLists.txtCMake 构建文件三套构建入口。库与示例分离的组织方式使得集成方既可以整体复制源码也可以通过 qmake/CMake 以子目录或安装包的形式复用。1.1 源码结构一览路径内容QXlsx/header/全部公开头文件xlsxdocument.h、xlsxworksheet.h、xlsxcell.h、xlsxchart.h等及私有实现头文件*_p.hQXlsx/source/34 个实现文件如xlsxdocument.cpp、xlsxworksheet.cpp、xlsxzipreader.cpp、xlsxzipwriter.cpp等QXlsx/QXlsx.priqmake 集成文件声明头文件路径、源文件列表、C 标准及平台宏QXlsx/CMakeLists.txtCMake 构建文件生成QXlsx::QXlsx目标并支持安装导出QXlsx/QXlsx.pro将 QXlsx 本身作为独立工程构建的 qmake 工程文件从 QXlsx/header/xlsxdocument.h 可以看出库的核心入口类是QXlsx::Document继承自QObject使用 Qt 的 D-Pointer 私有实现模式其公开接口覆盖了单元格读写、图片插入、图表插入、单元格合并、行列格式、数据验证、条件格式、工作表管理、文档属性、CSV 导出以及基于 SAX 的流式读取等能力具体将在第 4 节展开。2. 官方文档脉络如何“使用”与“安装”README.zh-CN.md 将使用路径清晰地划分为两大部分如何使用How to use阅读 Example.md内含 HelloWorld、TestExcel、HelloAndroid、WebServer、ShowConsole、ReadColor、csv、ExcelViewer、LargeData、ExcelTableEditor、FormulaDump 及 SAX 读取等完整示例如何设置/安装How to set up按构建系统分为两条路线——qmake 路线HowToSetProject.zh-CN.mdCMake 路线HowToSetProject-cmake.zh-CN.md。仓库同时提供中文版文档README.zh-CN.md、HowToSetProject.zh-CN.md、HowToSetProject-cmake.zh-CN.md方便中文开发者直接阅读。下面分别对 qmake 与 CMake 两条安装路线做完整展开。3. 安装与集成qmake 与 CMake 双路线详解3.1 路线一qmake 方式适用于 Qt Creator / .pro 工程以下流程来自 HowToSetProject.zh-CN.md适用于 qmake 构建系统基于 Windows 讲解Linux/macOS 流程类似。第 1 步克隆源码git clone https://github.com/j2doll/QXlsx.git第 2 步启动 Qt Creator新建一个你自己的 Qt 项目本示例为控制台应用程序。第 3 步复制 QXlsx 到你的项目目录在项目目录下执行按本机路径修改源路径与目标路径xcopy c:\workspace\github\QXlsx\QXlsx c:\workspace\HelloQXlsx /s /e第 4 步在*.pro文件中追加 QXlsx 配置在 Qt 项目文件如HelloWorld.pro中追加如下 qmake 代码# QXlsx code for Application Qt project QXLSX_PARENTPATH./ # 当前 QXlsx 所在路径. 表示当前目录 QXLSX_HEADERPATH./header/ # 当前 QXlsx 头文件路径 QXLSX_SOURCEPATH./source/ # 当前 QXlsx 源文件路径 include(./QXlsx.pri)第 5 步设置头文件与命名空间编写 HelloWorld 代码// main.cpp #include QCoreApplication #include xlsxdocument.h #include xlsxchartsheet.h #include xlsxcellrange.h #include xlsxchart.h #include xlsxrichstring.h #include xlsxworkbook.h using namespace QXlsx; int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); QXlsx::Document xlsx; xlsx.write(A1, Hello Qt!); // write Hello Qt! to cell(A,1). its shared string. xlsx.saveAs(Test.xlsx); // save the document as Test.xlsx return 0; // return a.exec(); }第 6 步构建并运行。成功后会在可执行文件旁生成Test.xlsx文件。3.1.1QXlsx.pri关键配置项解析QXlsx/QXlsx.pri 是 qmake 集成的核心其中对三个路径变量的处理值得关注isEmpty(QXLSX_PARENTPATH) { message( QXLSX_PARENTPATH is empty. use default value. ) QXLSX_PARENTPATH $$PWD/../ } else { message( $${QXLSX_PARENTPATH} ) } isEmpty(QXLSX_HEADERPATH) { QXLSX_HEADERPATH $$PWD/../QXlsx/header/ } isEmpty(QXLSX_SOURCEPATH) { QXLSX_SOURCEPATH $$PWD/../QXlsx/source/ }三个变量QXLSX_PARENTPATH、QXLSX_HEADERPATH、QXLSX_SOURCEPATH均可省略未设置时QXlsx.pri会回退到以$$PWD/../为基准的默认值即假定QXlsx.pri位于工程子目录QXlsx/下、库源码在上一级目录若你的项目采用把QXlsx目录整体复制到工程内的组织方式则按上文第 4 步显式指定三个路径即可QXlsx.pri还根据 Qt 版本自动设置 C 标准Qt 5 使用 C11Qt 6 使用 C17并定义QT_DEPRECATED_WARNINGS同时按平台自动追加头文件搜索路径如win32-g、win32-msvc2019、unix、mac等分支。仓库内的 HelloWorld/HelloWorld.pro 正是这一用法的实例——它注释给出了三个变量的推荐取值然后直接include(../QXlsx/QXlsx.pri)引入库源码并声明SOURCES main.cpp。这意味着示例工程并未把 QXlsx 复制进自身目录而是通过相对路径引用仓库内的库源码。3.2 路线二CMake 方式适用于现代 CMake / Qt6CMake 配置流程来自 HowToSetProject-cmake.md提供三种用法。3.2.1 安装 QXlsx 到系统mkdir build cd build cmake ../QXlsx/ -DCMAKE_INSTALL_PREFIX... -DCMAKE_BUILD_TYPERelease cmake --build . cmake --install .3.2.2 在你的应用中使用已安装场景在CMakeLists.txt中加入find_package(QXlsxQt5 REQUIRED) # 或 QXlsxQt6 target_link_libraries(myapp PRIVATE QXlsx::QXlsx)3.2.3 不安装、直接以子目录使用方式一add_subdirectoryadd_subdirectory(QXlsx) target_link_libraries(myapp PRIVATE QXlsx::QXlsx)方式二FetchContentFetchContent_Declare( QXlsx GIT_REPOSITORY https://github.com/QtExcel/QXlsx.git GIT_TAG sha-of-the-commit SOURCE_SUBDIR QXlsx ) FetchContent_MakeAvailable(QXlsx) target_link_libraries(myapp PRIVATE QXlsx::QXlsx)说明若未设置QT_VERSION_MAJORQXlsx 的CMakeLists.txt会自动探测并选择 Qt 5 或 Qt 6。3.2.4 CMake 构建配置的源码级印证QXlsx/CMakeLists.txt 详细展示了上述配置背后的实现cmake_minimum_required(VERSION 3.16)工程名为QXlsx、版本1.5.1未定义QT_VERSION_MAJOR时执行find_package(QT NAMES Qt6 Qt5 COMPONENTS Core Gui REQUIRED)自动选择 Qt 版本随后find_package(Qt${QT_VERSION_MAJOR} COMPONENTS Core Gui REQUIRED)导出目标名按 Qt 版本区分EXPORT_NAME QXlsxQt${QT_VERSION_MAJOR}因此安装后对应find_package(QXlsxQt5)或find_package(QXlsxQt6)而链接目标统一为QXlsx::QXlsx通过add_library(QXlsx::QXlsx ALIAS QXlsx)建立别名C 标准按 Qt 版本自动设定Qt 6 为 C17Qt 5 为 C11BUILD_SHARED_LIBS选项默认关闭历史原因保留为 OFF即默认构建静态库开启时定义QXlsx_SHAREDLIB宏内部链接Qt::Core与Qt::GuiPrivateQt 6.10 需要显式查找GuiPrivate组件通过install(EXPORT ... NAMESPACE QXlsx::)生成QXlsxQt5Targets.cmake/QXlsxQt6Targets.cmake并导出Config.cmake供find_package使用。仓库中的 HelloWorld/CMakeLists.txt 是add_subdirectory用法的直接范例它先find_package(QT NAMES Qt6 Qt5 ...)与find_package(Qt${QT_VERSION_MAJOR} ...)再add_subdirectory(QXlsx)并target_link_libraries(HelloWorld PRIVATE QXlsx::QXlsx)。3.3 两条路线的对比与选型建议维度qmake.priCMake.cmake集成方式include(./QXlsx.pri)直接编译源码进工程add_subdirectory/FetchContent/find_packageinstall路径变量QXLSX_PARENTPATH、QXLSX_HEADERPATH、QXLSX_SOURCEPATH可省略有默认值QXLSX_PARENTPATH、QXLSX_HEADERPATH、QXLSX_SOURCEPATHCMake 版同样支持C 标准Qt5→C11Qt6→C17由 .pri 自动设置同上由 CMakeLists.txt 自动设置安装/导出源码内嵌为主支持cmake --install与find_package(QXlsxQt5/QXlsxQt6)典型场景Qt Creator 传统工程、qmake 项目现代 CMake 工程、Qt6、CI 构建需要说明的是CMake 版本同样支持在 CMake 层面定义QXLSX_PARENTPATH等变量QXlsx/CMakeLists.txt 第 37–47 行对三者做了与 .pri 一致的默认值回退。无论选择哪条路线最终效果都是把 QXlsx 的全部源文件编译进你的应用运行期无需额外动态库。4. 核心 API 与底层实现Document类剖析4.1 构造、读写与保存从 QXlsx/header/xlsxdocument.h 可见Document的三种构造方式explicit Document(QObject *parent nullptr); // 新建空文档 Document(const QString xlsxName, QObject *parent nullptr); // 从文件路径加载 Document(QIODevice *device, QObject *parent nullptr); // 从 I/O 设备加载核心读写接口bool write(const CellReference cell, const QVariant value, const Format format Format()); bool write(int row, int col, const QVariant value, const Format format Format()); QVariant read(const CellReference cell) const; QVariant read(int row, int col) const; std::shared_ptrCell cellAt(const CellReference cell) const; std::shared_ptrCell cellAt(int row, int col) const; bool save() const; bool saveAs(const QString xlsXname) const; bool saveAs(QIODevice *device) const; bool isLoadPackage() const; bool load() const; // equals to isLoadPackage()在源码 QXlsx/source/xlsxdocument.cpp 中write(int, int, QVariant, Format)的实现是把调用转发给当前工作表bool Document::write(int row, int col, const QVariant value, const Format format) { if (Worksheet *sheet currentWorksheet()) return sheet-write(row, col, value, format); return false; }同理read与insertImage也都是基于currentWorksheet()的转发式实现xlsxdocument.cpp。可以推断QXlsx 的Document是面向当前活动工作表的门面Facade类真正的单元格读写逻辑在Worksheet层完成Document负责协调 Workbook、Worksheet 与最终打包为.xlsxZIPXML的过程。QVariant是 QXlsx 数据交换的统一类型因此write可以传入QString、double、int、QDateTime、bool等任意 Qt 原生类型相应地HelloWorld/main.cpp 中读取侧使用cell-readValue()取回QVariant通过qDebug()即可直接打印。4.2 更丰富的工作表操作Document还提供行/列格式化、合并单元格、图片与图表、数据验证与条件格式、工作表管理、命名区域、文档属性、CSV 导出等接口xlsxdocument.h能力代表性接口行列格式setColumnWidth/setColumnHidden/setColumnFormatsetRowHeight/setRowHidden/setRowFormatgroupRows/groupColumns合并单元格mergeCells(const CellRange, const Format)/unmergeCells图片insertImage(row, col, QImage)、getImage(...)、getImageCount()图表insertChart(row, col, QSize)数据验证/条件格式addDataValidation/addConditionalFormatting工作表管理addSheet/insertSheet/selectSheet/renameSheet/copySheet/moveSheet/deleteSheet/sheetNames()命名区域defineName(name, formula, comment, scope)文档属性documentProperty(name)/setDocumentProperty(...)其他autosizeColumnWidth(...)、saveAsCsv(...)、静态方法copyStyle(from, to)这些能力与 Example.md 中 TestExcel 示例组一一对应calendar、chart、chartsheet、datavalidation、mergecells、numberformat、rowcolumn、style、worksheetoperations 等可作为继续深入的代码起点。5. 官方示例纵览从 HelloWorld 到 SAX 流式读取Example.md 提供了完整的示例索引以下按类别归纳示例源码均位于仓库各子目录中HelloWorldHelloWorld/最简读写程序。写侧Document xlsxW; xlsxW.write(row, col, value); xlsxW.saveAs(Test.xlsx)读侧Document xlsxR(Test.xlsx); xlsxR.load(); cellAt(row, col)-readValue()。仓库中的 HelloWorld/main.cpp 是完整可运行版本其中saveAs成功与否通过返回值判断并打印调试信息TestExcelTestExcel/基于 QtXlsx 经典示例的基础功能集覆盖日历calendar.cpp、图表chart.cpp、图表工作表chartsheet.cpp、数据验证datavalidation.cpp、文档属性documentproperty.cpp、数据抽取extractdata.cpp、公式formulas.cpp、超链接hyperlinks.cpp、图片image.cpp、合并单元格mergecells.cpp、数字格式numberformat.cpp、页边距pageMargins.cpp、样式读取readStyle.cpp、富文本richtext.cpp、行列rowcolumn.cpp、样式style.cpp、工作表操作worksheetoperations.cpp等HelloAndroidHelloAndroid/QML 与原生 C 结合的 Android 示例WebServerWebServer/加载 xlsx 并通过 Web 展示连接http://127.0.0.1:3001要求 C14/17旧编译器不受支持ShowConsoleShowConsole/控制台展示 xlsx 内容用法ShowConsole *.xlsx要求 C11ReadColorReadColor/读取单元格颜色csvcsv/将 xlsx 保存为 csv核心调用为xlsxDoc.saveAsCsv(csvFileName)ExcelViewerExcelViewer/用 Qt Widgets 展示 xlsxLargeDataLargeData/大规模数据写入/读取基准示例支持命令行参数见下文表格ExcelTableEditorExcelTableEditor/带多工作表、QTableView 展示、编辑、格式保留、工作表重命名/增删/排序的表格编辑器sax readerTestExcel/extractdata_sax.cpp低内存的 SAX 流式读取示例FormulaDumpFormulaDump/公式与值导出工具。5.1 LargeData大规模数据压测参数表Example.md 为 LargeData 给出了命令行参数表这里完整保留并补充注释选项说明默认值--rows n/-r n生成的行数100000--cols n/-c n生成的列数10--use-style/-s应用简单的单元格格式关闭--sheet-rows n/-S n每个工作表的最大行数0 单个工作表0示例用法LargeData --rows 200000 --cols 20 生成 200,000 行 × 20 列 LargeData -r 100000 -c 10 --use-style 应用单元格格式 LargeData -r 200000 -c 10 -S 50000 按每个工作表 50,000 行拆分到多个工作表 LargeData -r 300000 -c 15 -S 60000 --use-style 组合使用全部选项该示例可用于性能测试、基准对比以及大数据负载下的 QXlsx 行为验证。5.2 SAX 流式读取低内存解析方案对于超大表格Document::read_sheet_sax提供边解析边回调、不驻留全部单元格的流式读取方式xlsxdocument.h。其回调协议定义在 QXlsx/header/xlsxreadsax.hstruct sax_options { bool resolve_shared_strings true; bool read_formulas_as_text false; bool stop_on_empty_sheetdata false; }; struct sax_cell { QString sheet_name; int row 0; // 1-based int col 0; // 1-based QVariant value; // bool/double/QString 等 }; using sax_cell_callback std::functionbool(const sax_cell);Example.md 给出了完整用法void dump_all_sheets_sax(QXlsx::Document doc) { QXlsx::sax_options opt; opt.resolve_shared_strings true; // 字符串多时设为 false 可更省内存但可能输出 sharedString 索引 opt.read_formulas_as_text true; // 以字符串形式输出公式而非结果值不需要时可设为 false opt.stop_on_empty_sheetdata false; // 即使 sheetData 为空也继续处理 const QStringList sheets doc.sheetNames(); qInfo() sheet count: sheets.size(); for (const QString sheet_name : sheets) { qInfo().noquote() \n SHEET: sheet_name ; const bool ok doc.read_sheet_sax( sheet_name, opt, - bool { qDebug().noquote() QString(%1!R%2C%3 %4) .arg(cell.sheet_name) .arg(cell.row) .arg(cell.col) .arg(cell.value.toString()); return true; // 返回 true 表示继续 }); qInfo() sheet done: sheet_name ok ok; } }结合 xlsxreadsax.h 可见底层通过QXmlStreamReader逐个解析sheetN.xmlsax_cell.row/col均为 1 基编号回调返回false可提前终止解析。这一机制在读取超大型 xlsx 时能显著降低峰值内存是从源码结构可以确认的结论。5.3 FormulaDump公式导出工具Example.md 中 FormulaDump 的用法与参数如下./FormulaDump xlsx-file [options]选项说明--sheet name只导出指定工作表--all导出所有工作表--only-formula只输出公式单元格--show-value输出单元格值--eval-formula无缓存值时尝试求值公式--max-rows n限制最大行数--max-cols n限制最大列数--print-empty值为空时也输出单元格需要说明的是FormulaDump 仅支持少数公式、-、SUM、AVERAGE、MIN、MAX其求值实现位于 FormulaDump/mini_formula_evaluator.cpp属于轻量级的公式求值辅助工具并非完整的 Excel 公式引擎。6. 常见问题与扩展资源结合 README.zh-CN.md 与仓库实际内容整理以下注意事项语言要求不同示例对 C 标准要求不同——ShowConsole 需 C11WebServer 需 C14/17库本身由QXlsx.pri/CMakeLists.txt按 Qt 版本自动选择标准Qt5→C11Qt6→C17共享字符串与内存使用 SAX 读取时resolve_shared_strings会在可读性与内存占用之间取舍对含大量重复字符串的工作簿关闭解析可显著降低内存占用代价是回调中可能拿到 sharedString 索引而非文本公式求值能力边界QXlsx 定位为 xlsx 读写库read_formulas_as_text与 FormulaDump 的--eval-formula表明缓存值缺失时只有极少量公式可被求值复杂公式建议由 Excel/WPS 等宿主软件计算后写入缓存静态库使用方式CMake 构建默认BUILD_SHARED_LIBSOFF即产出静态库qmake 方式则直接把全部源文件编译进应用二者均无需运行期额外动态库文档与测试环境README 提供了 Wiki 与 FAQ 链接并配有 GitHub Actionsqmake 与 CMake 两套流水线持续验证构建环境仓库内appveyor.yml亦提供了 Windows 上的持续集成配置。7. 总结本文围绕 README.zh-CN.md 的官方脉络系统讲解了 QXlsx 的项目定位、qmake/CMake 两种集成方式及其源码级实现依据、Document核心 API、官方示例全貌以及大规模数据与 SAX 流式读取的实战要点。无论你是要在 Qt Widgets 桌面应用中嵌入 Excel 读写能力还是需要在服务端/移动端以轻量方式处理.xlsx都可以按照克隆源码 → 选择构建路线 → 集成 .pri 或 CMake 目标 → 调用 Document API的路径快速上手。建议下一步结合 Example.md 中的 TestExcel 与 LargeData 示例对照 QXlsx/header/ 与 QXlsx/source/ 的源码逐步深入。赞分享数据分析【免费下载链接】QXlsxExcel file(*.xlsx) reader/writer library using Qt. Descendant of QtXlsxWriter.项目地址https://gitcode.com/gh_mirrors/qx/QXlsx点击查看免费下载相关推荐LunaTranslator游戏实时翻译工具指南从解压到看到第一句中文字幕LunaTranslator游戏实时翻译工具指南从解压到看到第一句中文字幕 LunaTranslator是一款免费开源的游戏实时翻译工具它从正在运行的视觉小数据分析QXlsx基于 Qt 的 Excel(.xlsx) 读写库——从项目概览到 qmake/CMake 集成实战QXlsx基于 Qt 的 Excel .xlsx 读写库——从项目概览到 qmake/CMake 集成实战 QXlsx 是一个使用 C配合 Qt开发的数据分析QXlsx 项目配置实战在 Qt Creator 中集成 XLSX 读写库的完整指南qmake 与 CMake 双方案QXlsx 项目配置实战在 Qt Creator 中集成 XLSX 读写库的完整指南qmake 与 CMake 双方案 QXlsx 是一个基于 Qt 的数据分析上一篇Bootstrap Icons 的 caret-up-square-fill 图标SVG 结构、字体码点与四种使用方式详解下一篇mHC 流形约束超连接如何稳住 43 层信号DwarfStar 本地推理引擎的 Metal 实现指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考