Strapi v5部署时如何保留「配置视图」的字段标签修改?
Strapi v5 持久化字段标签配置的官方方案
在Strapi v5中,通过UI「配置视图」修改的字段标签默认仅存储在本地数据库/缓存中,部署新环境时会丢失。你之前尝试的displayName字段在v5中已不再生效,正确的做法是通过集合类型的Schema文件配置pluginOptions来持久化显示名称,这也是官方推荐的方式。
具体操作步骤:
- 定位到目标集合类型的Schema文件,路径通常为
src/api/[你的集合类型名]/content-types/[你的集合类型名].schema.ts - 针对单个字段配置显示标签:
在字段定义中添加pluginOptions.contentManager.field.label,示例如下:export default { kind: 'collectionType', name: 'article', fields: [ { name: 'post_title', // 技术字段名 type: 'string', pluginOptions: { contentManager: { field: { label: '文章标题' // 编辑界面显示的直观标签 } } } }, // 其他字段同理 ] }; - 配置集合类型本身的显示名称:
如果需要修改集合类型在侧边栏或顶部导航的显示名称,同样在Schema根节点添加pluginOptions:export default { kind: 'collectionType', name: 'article', pluginOptions: { contentManager: { collection: { label: '文章管理' // 集合类型的显示名称 } } }, // 其他配置... };
注意事项:
- 修改Schema文件后,需重启Strapi服务使配置生效
- 该配置属于代码的一部分,部署时随项目代码同步到新环境,不会丢失
- 若之前通过UI修改过标签,Schema中的配置会覆盖UI的临时设置,确保环境一致性
内容的提问来源于stack exchange,提问作者donny.dee
相关产品推荐
相关产品推荐

