本指南记录了不同主题.json版本和如何升级。将继续支持使用旧版本。建议升级，因为新版本中将继续进行新的开发。
升级到v2可以启用一些新功能，并调整一些旧功能的命名，使其彼此更加一致。
- 更新
版本到2.
- 如果您正在使用更新的属性，请重命名这些属性（请参见下文）。
请参阅发行版的开发说明和参考文件适用于各自的v1和v2版本。
| 第1版 |
第2版 |
settings.border.customRadius（设置.订单.自定义半径） |
设置.顺序.半径 |
设置.spacing.customMargin |
设置.spacing.margin |
设置.spacing.customPadding |
设置.设置.添加 |
设置.排版.自定义线条高度 |
设置.typography.line高度 |
新的顶级属性：自定义模板,模板部件.
添加到设置：
设置.外观工具设置.顺序.颜色设置.border.style设置.order.width设置.颜色.背景settings.color.defaultGradients设置颜色默认渐变settings.color.defaultPalette设置颜色默认调色板设置.颜色.textsettings.spaceing.block间隙设置.typography.fontFamilies设置.typography.fontStyle设置.typography.fontWeight设置.打印.字母间距设置.typography.text列设置.typography.text装饰设置.typography.text转换
添加到样式：
样式.边框.颜色样式.border.style样式.订单.宽度样式.过滤器.uotone样式.spacing.blockGap样式.typography.fontFamily样式.typography.fontStyle样式.typography.fontWeight样式.字体.字母间距styles.typegraphy.text列styles.typegraphy.text装饰styles.typegraphy.text转换
核心提供的默认字体大小(设置.排版.font尺寸)已更新。普通和超大尺寸（带正常的和巨大的slugs）已从列表中删除，并且超大型(特大添加了slug）。当UI控件显示core提供的默认值时，Normal和Huge将不再出现。然而，他们的CSS类和CSS自定义属性仍在排队，以确保使用它们的现有内容仍能按预期工作。
升级到v3会调整预设默认值，使其彼此更加一致。
- 更新
版本到三.
- 配置更改的默认值（见下文）。
设置.typography.defaultFontSizes
在theme.json v2中，只有在未定义主题大小时才显示默认字体大小。如果一个主题提供了与默认值相同的字号，那么它总是会覆盖这些字号。
默认值字体大小段塞为：小的,中等的,大的,特大、和xx-大.
新的默认字体大小选项可以控制显示默认字体大小并防止覆盖这些默认值。
- 设置为时
真的它将显示默认的字体大小，并防止它们被主题覆盖。
- 设置为时
假它将隐藏默认字体大小，并允许主题使用默认的slugs。
它是真的默认情况下，当切换到v3时。这与其他默认*选项的工作方式如下settings.color.defaultPalette设置颜色默认调色板，但与v2中的行为不同。
要使用v3 theme.json保持与v2类似的行为，请执行以下操作：
*如果你没有字体大小定义，默认字体大小可以省略或设置为真的.
*如果你有一些字体大小定义，设置默认字体大小到假.
设置.spacing.defaultSpacingSizes
在theme.json v2中，有两种设置可用于设置主题级间距大小：设置.空间.空间大小和设置。间距。间距缩放.设置两者间距大小 和 间距比例将只使用中的值间距大小。设置其中任何一个都会替换WordPress提供的整套默认间距大小。
默认值间距大小WordPress提供的slug有：20,30,40,50,60,70、和80.
新的默认间距大小选项可以控制显示默认间距大小并防止覆盖这些默认值。
- 设置为时
真的它将显示默认的间距大小，并防止它们被主题覆盖。
- 设置为时
假它将隐藏默认的间距大小，并允许主题使用默认的slug。
默认间距大小是真的默认情况下，当切换到v3时。这与其他默认*选项的工作方式如下settings.color.defaultPalette设置颜色默认调色板，但与v2中的行为不同。
此外，在v3中间距大小和间距比例可以同时设置。中定义的预设间距大小带有与生成的预设匹配的段塞间距大小将覆盖生成的。
要使用v3 theme.json保持与v2类似的行为，请执行以下操作：
*如果你没有间距大小预设或间距比例配置已定义，默认间距大小可以省略或设置为真的.
*如果通过设置禁用默认间距大小间距缩放到{“步骤”：0}，删除间距比例配置和设置默认间距大小到假.
*如果您只定义了其中之一间距比例或间距大小对于预设，请设置默认间距大小到假.
*如果您同时定义了这两个间距比例和间距大小，删除间距大小配置和设置默认间距大小到假.