# fsys.openXml.docx.builder 库模块帮助文档

[Word 生成指南](https://www.aardio.com/zh-cn/docs/library/fsys/openXml/docx/builder/index.html)

## fsys.openXml.docx.builder 成员列表 <a id="fsys.openXml.docx.builder" href="#fsys.openXml.docx.builder">&#x23;</a>

Word 结构化生成器；仅依赖公共 writer，不依赖 HTML、OpenXML 读取器、Office、MSXML 或 .NET。  
支持单节 DOCX、段落/标题、格式化运行、表格、编号、书签和超链接；不是完整 Word 排版引擎。

### fsys.openXml.docx.builder.buildParts(document,options) <a id="fsys.openXml.docx.builder.buildParts" href="#fsys.openXml.docx.builder.buildParts">&#x23;</a>
document={blocks=[...];numbering=[...]}。返回 name,data 部件数组,null,report；失败 null,err。  
不进行文件 IO；report 含 paragraphCount/tableCount/listCount/warnings。  
blocks 支持 paragraph/table；详见生成指南。文本不经过 HTML，0/false/空串保留。

### fsys.openXml.docx.builder.defaults <a id="fsys.openXml.docx.builder.defaults" href="#fsys.openXml.docx.builder.defaults">&#x23;</a>
公共默认选项，可修改。  
font/monoFont/symbolFont；fontSize=11/codeFontSize=10（磅）；lineSpacing/codeLineSpacing=1.15；  
A4 pageWidth=11906/pageHeight=16838（twips），margins 四边1440；landscape=false；  
colors 使用0xRRGGBB；title/author；overwrite=false。与 HTML 转换器的 defaults 不共用。

### fsys.openXml.docx.builder.normalizeOptions(options) <a id="fsys.openXml.docx.builder.normalizeOptions" href="#fsys.openXml.docx.builder.normalizeOptions">&#x23;</a>
合并/检查 Word 公共选项，返回新选项表；失败 null,err。不修改输入或 defaults。  
供 HTML 转换器等适配层复用纸张、字体、页边距和颜色规则。

### fsys.openXml.docx.builder.write(path,document,options) <a id="fsys.openXml.docx.builder.write" href="#fsys.openXml.docx.builder.write">&#x23;</a>
生成并原子保存 .docx，返回完整路径,null,report；失败 null,err。  
默认不覆盖，overwrite=true 允许替换；公共 writer 负责写入限额、临时包、关闭检查和目标保护。
