# fsys.openXml.xlsx.builder 库模块帮助文档

[» 原生 XLSX 生成](https://www.aardio.com/zh-cn/docs/library/fsys/openXml/xlsx/builder/)

## fsys.openXml.xlsx.builder 成员列表 <a id="fsys.openXml.xlsx.builder" href="#fsys.openXml.xlsx.builder">&#x23;</a>

普通 XLSX 原生数据生成器；独立导入，不加载 reader/MSXML/Office/PPT。\n支持有限报表样式：document.styles 命名样式（font/fill/border/alignment/numberFormat），单元格 style 引用；支持 sheet.columns/rows/merges/freeze/autoFilter。样式不是完整显示引擎。  
无公式计算/显示引擎；不编辑既有文件，不执行宏或外链。公式是可信输入，不是安全沙箱。

### fsys.openXml.xlsx.builder.buildParts(document,options) <a id="fsys.openXml.xlsx.builder.buildParts" href="#fsys.openXml.xlsx.builder.buildParts">&#x23;</a>
返回 name,data,level 部件数组,null,report；失败null,err；不写文件。  
document={sheets=[{name="数据";data=[[...]]}];date1904=false}。每页data/cells二选一。  
二维data从A1开始；cells=[{ref="B2";value=0},{ref="C2";formula="1+1";cached=2}]。  
null跳过、空串/0/false分别保存；普通字符串即使以=开头也不是公式。  
日期用time或{kind="date/datetime";value="无时区ISO"}，写数值和日期样式。  
formula显式指定，可选cached/cachedKind；无缓存不伪造0；缓存不是重算结果。

### fsys.openXml.xlsx.builder.write(path,document,options) <a id="fsys.openXml.xlsx.builder.write" href="#fsys.openXml.xlsx.builder.write">&#x23;</a>
原子写入.xlsx，返回完整路径,null,report；失败null,err。  
默认overwrite=false；protectPaths保护源文件及硬链接别名。  
maxSheets=100，maxCells=100000，maxInputSlots=1000000（含空白槽位），0为严格限额。  
maxEntries/maxPartBytes/maxWriteBytes/level同writer；可设creator/title。  
report含sheetCount/cellCount/inputSlots/dateCellCount/formulaCount/cachedFormulaCount/missingFormulaCacheCount/date1904/recalcRequested/sheets/warnings。  
无通用样式、图表、表对象、宏；样式只覆盖低风险报表子集，不保证精确显示/复杂对象；16位及以上整数请用文本。更多边界见指南。