【亲测免费】 OpenXLSX 项目使用教程

1. 项目的目录结构及介绍

OpenXLSX 是一个用于读写、创建和修改 Microsoft Excel® (xlsx) 文件的 C++ 库。项目的目录结构如下：

OpenXLSX/
├── Benchmarks/
├── Documentation/
├── Examples/
├── OpenXLSX/
├── Tests/
├── clang-format
├── clang-tidy
├── gitignore
├── CMakeLists.txt
├── LICENSE.md
├── Makefile.GNU
├── README.md
├── vcpkg.json

目录介绍

• Benchmarks/: 包含性能测试相关的文件。
• Documentation/: 包含项目文档，如 API 参考手册等。
• Examples/: 包含使用 OpenXLSX 的示例代码。
• OpenXLSX/: 包含库的核心源代码和头文件。
• Tests/: 包含单元测试和集成测试代码。
• clang-format: 用于代码格式化的配置文件。
• clang-tidy: 用于代码静态分析的配置文件。
• gitignore: Git 版本控制忽略文件配置。
• CMakeLists.txt: CMake 构建系统的配置文件。
• LICENSE.md: 项目许可证文件。
• Makefile.GNU: GNU Make 构建系统的配置文件。
• README.md: 项目说明文档。
• vcpkg.json: vcpkg 包管理器的配置文件。

2. 项目的启动文件介绍

OpenXLSX 项目的启动文件通常是 Examples/ 目录下的示例代码文件。这些文件展示了如何使用 OpenXLSX 库进行基本的 Excel 文件操作。

例如，Examples/BasicUsage.cpp 文件展示了如何创建一个新的 Excel 文件、添加工作表、写入数据等基本操作。

#include "OpenXLSX.hpp"

int main() {
    OpenXLSX::XLDocument doc;
    doc.create("Example.xlsx");
    auto wks = doc.workbook().addWorksheet("Sheet1");
    wks->cell("A1").value() = "Hello, OpenXLSX!";
    doc.save();
    return 0;
}

3. 项目的配置文件介绍

OpenXLSX 项目的配置文件主要包括 CMakeLists.txt 和 vcpkg.json。

CMakeLists.txt

CMakeLists.txt 是 CMake 构建系统的配置文件，定义了项目的构建规则和依赖关系。

cmake_minimum_required(VERSION 3.10)
project(OpenXLSX)

set(CMAKE_CXX_STANDARD 17)

add_subdirectory(OpenXLSX)
add_subdirectory(Examples)
add_subdirectory(Tests)

vcpkg.json

vcpkg.json 是 vcpkg 包管理器的配置文件，用于管理项目的依赖库。

{
  "name": "openxlsx",
  "version-string": "4.2.6.1",
  "description": "A C++ library for reading, writing, creating and modifying Microsoft Excel® (xlsx) files.",
  "dependencies": [
    "pugixml"
  ]
}

通过这些配置文件，开发者可以方便地构建和部署 OpenXLSX 项目。