Magicodes.IE.IO：XLSX I/O 管线：数据如何进出工作簿-北京尧图网络

一区分很重要。把组件称为“Excel 引擎”很容易让读者期待一个可随机编辑、可计算公式、可保留全部工作簿状态的对象模型。本文讨论的是另一类问题在文件、HTTP 响应或上传流上怎样可靠地读写 XLSX 数据。导出对象怎样变成 ZIP 输出高层入口可以很简单// Foo 与 foos 的定义见第 00 篇。Xlsx.Write(“foo.xlsx”, foos);await Xlsx.WriteAsync(response.Body, asyncFoos, cancellationToken: ct);内部写入路径大致如下IEnumerable / IAsyncEnumerable↓ExportProfile↓ 冻结配置构建 RowPlan列元数据 / getter / cell writer / 样式↓XlsxWriter↓ 逐行生成 worksheet XMLByteBufferWriter↓ 局部 XML 字节缓冲ForwardOnlyZipWriter↓ Local Header / 数据 / Data DescriptorStream / IBufferWriter / 文件这里有两类状态逐行状态当前 row、当前 cell、局部 XML 缓冲工作簿状态styles、sheet 信息、SST、Central Directory 元数据逐行状态可以持续推进工作簿状态要到完成时才能写出全部内容。比如启用 SST 时唯一字符串表必须保存到结束ZIP 的 Central Directory 也要等所有 entry 完成后写入。导入ZIP 怎样变回对象读取入口对应另一条方向// Foo 的定义见第 00 篇。foreach (var foo in Xlsx.Read(stream)){// 按行消费}await foreach (var foo in Xlsx.ReadAsync(stream, cancellationToken: ct)){// 异步按行消费}Reader 的主路径是Stream↓ZipArchive├─ workbook.xml / workbook.xml.rels├─ date1904└─ sharedStrings.xml如存在↓第一个可读 worksheet XML↓ XmlReader 逐行读取稀疏列 / inline string / SST / 富文本↓XlsxReadPipeline表头 / 显式映射 / Converter / Source Generator↓T导入同样不是“整个文件都读入内存”。工作表 XML 行可以逐行消费但 Shared String Table 会整体加载输入流、ZIP 解压、当前行缓冲和业务对象也都占用内存。读写共享的结构约束导入和导出并不是两套无关代码它们都受同一份 OOXML 结构约束结构导出侧导入侧工作簿关系workbook relationship 写 workbook 与 sheet 的关系通过关系定位第一个 worksheet单元格引用写 A1、B1 等位置由引用恢复稀疏列位置inline string / SST 选择字符串存储策略还原字符串文本日期系统写 Excel 日期值与格式读取 date1904 后解析日期ZIP entry 顺序写 Data Descriptor 打开 entry 并读 XML对象映射属性写成列表头和列写回属性这也是本文后续按“包结构、单元格、字符串、映射、异步”来组织而不是把导入和导出拆成两套薄文章的原因。低分配的边界写入侧的热点路径会尽量减少临时数组和字符串池化字节缓冲、UTF-8 直接格式化、固定 XML 片段和生成的 cell writer 都服务于这个目标。但“低分配”不是整条 I/O 管线的通行证ToBytes 必然物化最终 byte[]netstandard2.0 有兼容分支SST 会维护全量唯一字符串表Reader 会加载 sharedStrings真正异步 I/O 有状态机和底层流成本DTO 映射仍会创建业务对象。因此文章中的性能结论必须限定到具体 API、TFM、数据形态和输出/输入目标。流所有权也不同API 默认所有权Xlsx.Write(Stream, …) 调用方负责释放输出 streamXlsx.WriteAsync(Stream, …) 调用方负责释放输出 streamXlsx.Read(Stream, …) 枚举结束时 Reader 默认关闭输入 streamXlsx.ReadAsync(Stream, …) 枚举结束时 Reader 默认关闭输入 stream读取时如果调用方仍要使用输入流应传 leaveOpen: true。输出响应开始写入后也不能回滚已发送的 ZIP 字节这些生命周期问题和性能同样属于 I/O 设计的一部分。

Magicodes.IE.IO：XLSX I/O 管线：数据如何进出工作簿

相关推荐

C++实战：从零构建手机通讯录管理系统，掌握面向对象与STL容器应用

VRTK-3.2.1：Unity VR交互开发的模块化框架实战指南

Apple诉OpenAI：AI商业机密纠纷对硬件生态与开发者的影响

更多资讯

Readest OPDS 分组轮播实现解析：基于 react-virtuoso 的虚拟化横向卡片滑轨与懒加载封面

使用 Go 标准库 time 正确处理时间：Uber Go Style Guide 时间处理实践全解析

如何给SumatraPDF贡献代码？从构建、调试到提交PR的完整开发者指南

Naive UI 创建适配主题的自定义组件：n-config-provider、n-element 与 useThemeVars 全面指南

UIkit快速开始教程：CDN、npm、pnpm五种安装方式与第一个响应式页面

Vercel CLI 告警规则：`vc alerts rules schema` 与内置/自定义告警规则创建实战指南

今日更新

OneUptime 自定义探针（Custom Probe）部署实战：私网监控、代理配置与断连排障全指南

大众TL52625前端框架材料要求详解：从性能测试到落地执行

TiXL 浮点运算算子库 Lib.numbers.float 完全指南：44 个算子的参数详解、源码原理与实战串联

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？