theme.json的version声明用于对应配置规范，不会升级站点本身，也不能让旧WordPress自动理解所有新字段。配置是否有效要看运行版本、支持字段和覆盖层，再用编辑器与前台输出验证。
先盘点运行环境与配置来源
记录WordPress、主题和相关区块插件版本，找出父主题、子主题及站点自定义各自提供的配置。不要只检查一个theme.json文件，用户在编辑器保存的设置也可能改变最终样式。版本记录应来自实际站点，而不是主题下载页的默认演示。
按当前规范核对具体字段
选择与部署环境匹配的官方schema，检查键名、类型和嵌套位置。JSON语法正确仅说明文件可解析，不代表字段在当前版本受支持。某个示例同时包含新旧能力时，应分别判断，不能整体复制后只把version数字调高。
在测试副本逐项引入配置
先保留原配置及站点导出，按颜色、排版或布局等独立功能小步修改。字段未生效时，核对作用到全局还是指定区块，以及是否被更具体设置覆盖。不要通过追加大量important样式来掩盖配置来源没有理清的问题。
检查控制项和生成样式
观察编辑器是否出现预期选项，并从前台计算后样式核对最终值。再测试旧内容、窄屏和未设置局部样式的区块，确认配置没有意外改变其他页面。若需要升级核心才支持，单独安排升级与兼容性检查。
关键区别
version声明：选择配置规范；不会升级WordPress。
字段语法：键名类型与层级；能解析不等于支持。
最终样式：来自多层合并；仍需查看覆盖来源。
怎样确认处理到位
配置通过语法和字段检查，编辑器控制及前台样式相符，旧内容与手机显示正常，适用核心版本和回退文件已经记录。
容易误判的边界
不能把官方新规范示例直接视为所有旧站可用。涉及升级的工作应独立验证，不以修改一个数字代替兼容性评估。
