# 定义 schema 参考 每个 DiceBear 头像样式都是一个遵循 [DiceBear Definition Schema](https://github.com/dicebear/schema) 的 JSON 文件。此页面 记录了样式定义的完整结构。 ## 概览 一个样式定义描述了生成头像所需的一切：canvas 尺寸、要渲染的 SVG 元素、可随机化的组件，以及可用的 颜色调色板。该定义完全是声明式的：没有代码，没有 函数。渲染逻辑位于 DiceBear Core 的实现中。 ## 顶层结构 ```json { "$schema": "https://...", "$id": "https://...", "$comment": "可选注释", "meta": { ... }, "canvas": { ... }, "components": { ... }, "colors": { ... }, "attributes": { ... } } ``` | 属性 | 必需 | 描述 | | ------------ | ---- | ------------------------------------------------------------------------------------ | | `$schema` | 否 | 用于编辑器验证的定义 schema URL | | `$id` | 否 | 此定义的规范标识符（通常为其托管地址的 URL，最多 256 个字符） | | `$comment` | 否 | 自由文本注释，例如 "Generated by Figma"（最多 4096 个字符） | | `meta` | 否 | 许可证、创建者和来源元数据 | | `canvas` | **是** | Canvas 尺寸和根元素树 | | `components` | 否 | 命名的、可随机化的 SVG 组件（最多 512 项） | | `colors` | 否 | 用于动态着色的命名颜色调色板（最多 512 项） | | `attributes` | 否 | 根 `