内容模型的自定义字段怎么设计，才不会做一半就得改表

内容模型的自定义字段怎么设计才不用改表，答案不在字段本身，而在设计顺序。返工多发生在「先建了字段，后来发现导入读不到、接口取不出、筛选没法用」，于是回头改表结构。避免这一点，要在建字段前把三个问题回答清楚。

内容模型和分类的分工

先分清两层：分类管的是内容怎么归堆、怎么在导航里出现；内容模型管的是同一类内容「长什么样」——有哪些字段、每个字段是什么类型。自定义内容模型解决的是「同一套后台承载多种内容结构」，比如文章、产品、案例需要各自不同的字段集合。分类不够用，往往是因为把「结构差异」错放进了「归类差异」。

字段设计先回答哪三个问题

第一个问题：这个字段以后要不要被单独引用？能被单独引用，就意味着它得是独立字段，而不是塞在正文里的一段文字。需要出现在列表页、筛选条件、接口返回里的信息，都算「要被单独引用」。

第二个问题：字段的类型和必填性定下来了吗？文本、数字、日期、枚举、图片各有各的存储与校验方式。类型定错，后面改一次就要回填一次历史数据；必填性定错，会出现关键字段大面积留空。能枚举的取值优先用枚举而不是自由文本。

第三个问题：批量导入和公开接口读得到它吗？这一步最容易被跳过，也最容易在「做一半」时暴露。

哪些返工点最容易发生

第一类是字段名频繁变更。名字一改，模板引用、导入映射、接口字段全跟着动。定字段名时按「语义」而不是「当前页面文案」命名，展示文案和字段名分开。

第二类是把展示逻辑塞进字段。比如把「原价 + 划线」这种带样式的结果存成一个字段，等于把渲染写进了数据，换一种展示就得改数据本身。字段只存事实值，样式交给模板。

第三类是忽略接口可读性。字段建在模型里，但公开接口不返回，前端和第三方就取不到，字段形同虚设。设计阶段就该确认它在接口文档里能被读到。

接口和导入能不能读到这些字段

这是判断「设计对不对」的两块试金石。AnQiCMS 支持自定义内容模型与灵活的内容结构，配套的批量导入支持 ZIP 压缩包和 Excel 表格——这意味着新字段要能在导入模板里有对应列，否则历史内容补不进新结构。另一头是公开接口，文档内容、分类与标签、自定义字段这类高频能力要能在接口里被调用读到；接口文档决定了前端和外部工具能不能稳定取到这些字段。

顺序因此很明确：先确定哪些字段要被引用 → 定类型与必填 → 确认导入列和接口字段能承载 → 再上线模型。这样字段一建立就有完整的数据通路，而不是建完之后回头补表。

常见问题

问：先少建几个字段，以后再加行不行？ 答：加字段比删字段安全，但每次加都要回填历史数据、补导入列、更新接口。能一次想清的常用字段，宁可建全，避免反复改表。

问：所有信息都做成自定义字段吗？ 答：不是。只把「需要被单独引用、筛选或接口读取」的信息独立成字段，其余留在正文即可，字段过多反而拖慢导入和查询。

问：字段类型选错了怎么补救？ 答：新建正确类型的字段、迁移数据、切换模板与接口引用，再废弃旧字段。迁移前先备份，逐类抽查值是否正确转换。