# QuickExcel

**Repository Path**: cwy-dev/quickexcel

## Basic Information

- **Project Name**: QuickExcel
- **Description**: 使用C++语言开发的一款读取、写入、编辑XLS文件的组件，欢迎各位爱好者一起维护。
- **Primary Language**: C++
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-22
- **Last Updated**: 2026-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuickExcel

#### 介绍
使用C++语言开发的一款读取. 写入. 编辑XLS文件的组件，欢迎各位爱好者一起维护。  

#### 开源说明

1.  QuickExcel是从BasicExcel 3.0组件衍生而来，按照[MS-XLS]协议来尝试实现所有的Record定义. 读取和写入。  
2.  由于开源代码BasicExcel 3.0使用了CPOL开源协议，本次开源代码中不包含。  
3.  本开源代码使用Apache-2.0开源协议。  


#### 软件架构

0.  本源代码使用VS2010进行开发，尽量使用std中的接口，没有使用或尽量少用MFC的接口。
1.  [Y] 宏定义[MS-XLS]中所有Record类型；  
2.  [Y] 定义所有Record结构体，目前已完成100+的Record内容字段定义，其他仅空壳  
3.  [P] 实现所有Record的读取，目前已完成所有定义完整内容字段的Record的Read函数，其他仅空壳；读取链路已通  
4.  [N] 实现所有Record的写入，目前已完成所有定义完整内容字段的Record的Write函数，其他仅空壳；写入链路已通 (部分Record需要全局计算偏移量等)  
5.  对外总接口：QuickExcel类  
6.  QuickExcel: 对外接口。QuickExcel, ExlWorkbook, ExlWorksheet, ExlCell (定义mCellData指向单元格数据如字符串. 数字. 公式. 超链接等)  
6.  BasicTypes: 基础数据类型定义（uint8_t, uint16_t, uint32_t, uint64_t等）  
8.  CompoundFile: XLS文件的读取和写入CompoundFile. 和核心的Record读写的辅助类ExlBuffer  
9.  ExcelTypes：所有Record的结构体定义 （后半部分是空壳定义，待完善）  
10.  ExlComStructs: 公共结构体、类、宏定义等，包括ERK（RK数据类型），ExlGUID，Cell单元格地址，estring（UNICODE字符串读写），VirtualPath，eformater（单元格格式管理器），SSTable（SST字符串表），Hyperlink（超链接），econdformater（条件格式管理器）等  
11.  ExlFormula：公式。含公式编码（未完善）和解码（未测试全）  
12.  ExlXutility：通用工具函数、类  
13.  ExlBuffer：读取. 写入的核心功能，当前使用了little endian，且默认了系统是小端系统。如果需要大端接口，需要适配  


#### 修改说明

1.  Log输出：父类Record定义了虚函数toString用于输出Log到文件(自定义格式)；定义了虚函数toDemoString用于输出到CHtmlView中(有固定格式要求)  
2.  若完善了空壳Record，记得在RecordFactory::createRecord函数中，打开对应Record的注释，该Record即可正常读取。  
3.  xxxx   

#### 外部开源代码

1.  Theme Record的数据是裸DEFLATE数据，没有ZLIB/GZIP套壳，压缩的数据采用了[开源代码miniz 3.1.2](https://github.com/richgel999/miniz/releases) 来进行解压，  
2.    
3.    
4.    


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)