docx.load() 抛出“文件已损坏”异常，主因是word 2016+文档启用了“启用内容”、含数字签名或w:compat等不可见兼容元素；建议另存为标准.docx、禁用兼容模式或改用docx.create()新建填充。
DocX.Load() 为什么抛出“文件已损坏”异常
直接用 DocX.Load() 打开从 Word 2016+ 保存的 .docx 文件却报错，大概率是文档启用了“启用内容”或内嵌了受保护的 XML 结构（比如带数字签名的模板）。DocX 是纯托管实现，不解析 Office 的信任中心策略，也不支持加密/签名文档。
实操建议：
- 用 Word 手动另存为「Word 文档（*.docx）」，保存选项里取消勾选「保留文档格式和布局」和「禁用兼容模式」
- 确认源文件不是从 Outlook 邮件正文复制粘贴生成的——这类文档常含不可见的
w:compat元素，DocX 会跳过但可能引发后续段落索引错乱 - 临时改用
DocX.Create()新建空白文档再手动填充，绕过加载环节，适合合同范本这种结构固定的场景
替换文本时 ReplaceText() 不生效的三个常见原因
合同里写好占位符如 {{client_name}}，调用 doc.ReplaceText("{{client_name}}", "张三") 却没变，问题往往不在函数本身，而在文本分布形态。
实操建议：
- 占位符跨了多个
Paragraph或被拆进不同Run（比如加粗部分只包了花括号左半边），ReplaceText()默认只匹配完整、连续、同格式的文本片段 - 文档使用了「样式集」或「快速样式」，实际存储的是
StyleId而非纯文本，需先调用doc.Styles.AddStyle("Placeholder", "Normal")并显式应用 - 占位符藏在表格单元格里？DocX 的
ReplaceText()默认不递归进Table和Row，得手动遍历：foreach (var row in table.Rows) foreach (var cell in row.Cells) cell.ReplaceText(...)
插入条款列表时，InsertList() 导致编号错乱怎么办
合同常用多级编号条款（如“第一条”“1.1”“（1）”），但 InsertList() 只支持扁平化编号（1, 2, 3…），且无法绑定 Word 原生多级列表样式。
论文常用的tex格式转换为word格式，核心是能转换数学公式（非图片），表格，图表等等
下载
将 LaTeX（.tex）学术论文转换为 Word（.docx），支持可编辑的 OMML 公式、原生 Word 表格、嵌入图形、IEEE 双栏排版及参考文献
实操建议：
- 放弃
InsertList()，改用Paragraph.InsertParagraphBeforeSelf()+ 手动设置Paragraph.ListId和Paragraph.ListLevel，这两个属性需提前通过doc.AddList()创建对应层级的列表模板 - 若条款已存在 Word 模板中，优先用「书签（Bookmark）」定位：在模板里插
BookmarkStart标记位置，代码中用doc.Bookmarks["clause_1"].SetText("甲方应于...")替换整段，保留原有编号逻辑 - 注意 Word 2013+ 默认启用「自动编号续前序」，而 DocX 插入新列表时不会继承该状态，需显式设置
list.ContinuePreviousList = true
生成的 .docx 在 Mac 或 WPS 打开格式错位
Windows 上用 Word 2019 测试正常，但客户用 Mac 版 Word 或 WPS 打开后表格列宽归零、中文字体变成宋体、页眉页脚偏移——这不是 DocX 的 bug，而是它默认不写入某些兼容性元数据。
实操建议：
- 强制指定字体：不要依赖系统默认，对每个
Paragraph和Run显式设.Font("微软雅黑")或.FontSize(10.5) - 关闭自动调整：调用
table.AutoFit = false，并为每列设固定宽度column.Width = 1500（单位是 twips，1 英寸 = 1440 twips） - 保存前插入兼容声明：在
doc.SaveAs(path)前加一行doc.CustomProperties.Add("CompatibilityMode", "15");，模拟 Word 2013 兼容模式，能显著改善 Mac 端渲染
DocX 对复杂版式的支持始终是“够用但有边界”，合同这种法律文书真正难的不是生成，而是确保每一处空格、缩进、换行在任意终端都像素级一致。与其堆砌功能，不如把模板拆成原子化书签块，用最笨但最稳的方式逐段注入。
