DOCXKIT_STYLE_CIRCULAR_EXTENDS: 样式继承形成循环

extends 链引用了正在解析的样式类。

修复步骤

1. 沿错误消息中的继承链检查引用。
2. 删除闭合循环的引用，共用父样式仍然可用。

问题示例

import { createDocx, defineStyles } from 'docx-kit'

const styles = defineStyles({
  body: { extends: 'title' }, title: { extends: 'body' },
})
await createDocx({ styles }).p('Hello', { className: 'body' }).toBlob()

修复示例

import { createDocx, defineStyles } from 'docx-kit'

const styles = defineStyles({
  body: { fontSize: 12 }, title: { extends: 'body', fontSize: 24 },
})
const blob = await createDocx({ styles })
  .p('Hello', { className: 'title' }).toBlob()

常见原因

• 样式继承自身，或多个样式类互相继承形成闭环。

诊断字段

• code: STYLE_CIRCULAR_EXTENDS
• diagnosticCode: DOCXKIT_STYLE_CIRCULAR_EXTENDS
• name: DocxKitError
• docs: https://docx-kit.ntnyq.dev/errors/docxkit_style_circular_extends/

消息示例

Circular extends detected for style class "body". Chain: body → title → body

源码与相关指南

• 源码
• 相关指南
• 捕获错误
• 全部错误码