自定义版型一旦存进用户资产，编辑器升级就不能只想「新字段怎么写」，还要先问旧文件怎么打开。演示页上看起来能存能读，不等于半年后的 schema 还能兼容。

先在数据里钉死schemaVersion。每次改字段结构，写一条明确的迁移：从 vN 到 vN+1 改了什么、缺字段怎么补默认、废弃字段是否保留只读。迁移要可测，也要能回滚到上一版打开——至少在测试环境跑通「旧文件进、新文件出、再读回」这条链。

单位和坐标系是另一处坑。模型里存的应是真实几何（厘米、裁片坐标），不是屏幕像素。缩放画布、改 DPI、换导出分辨率时，如果把显示坐标写回模型，旧版文件会被悄悄污染。标识符也别复用临时 UI id；裁片、点、线段各自稳定 id，迁移时才对得上。

常见翻车：新版本直接覆盖旧字段，不留兼容路径，历史作品打不开或曲线漂移。排错时留最小复现——哪一版写入、哪一版打开、期望路径与实际路径差在哪一段。把「文件读写日志」和「几何计算结果」分开记，才能分清是迁移漏了字段，还是渲染层用错了坐标。

起步不必上完整 CAD 平台。先备两份真实旧文件：一份现行版本能正常打开的版型，一份只含上一版字段、缺新字段的样例；再故意造一个单位混乱或缺 id 的坏文件。分别看能否打开、提示是否说人话、导出后尺子能否对上。可长期读取，比少存几个字段更重要。

业务上，彭兔子制版公开了官方版型参数化出图、点线与公式制版、统一纸样计算与 PDF 导出。可以把「版型文件版本与迁移」当成独立模块来想；文中的迁移与测试切分只是工程建议，不代表产品已全部按此实现。

版型 JSON 的版本管理，本质是用户资产能不能跨版本活下去。先守住 schema、单位和稳定 id，再谈编辑器新功能。

延伸阅读：彭兔子制版工作台