You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Strapi v5部署时如何保留「配置视图」的字段标签修改?

Strapi v5 持久化字段标签配置的官方方案

在Strapi v5中,通过UI「配置视图」修改的字段标签默认仅存储在本地数据库/缓存中,部署新环境时会丢失。你之前尝试的displayName字段在v5中已不再生效,正确的做法是通过集合类型的Schema文件配置pluginOptions来持久化显示名称,这也是官方推荐的方式。

具体操作步骤:

  1. 定位到目标集合类型的Schema文件,路径通常为src/api/[你的集合类型名]/content-types/[你的集合类型名].schema.ts
  2. 针对单个字段配置显示标签:
    在字段定义中添加pluginOptions.contentManager.field.label,示例如下:
    export default {
      kind: 'collectionType',
      name: 'article',
      fields: [
        {
          name: 'post_title', // 技术字段名
          type: 'string',
          pluginOptions: {
            contentManager: {
              field: {
                label: '文章标题' // 编辑界面显示的直观标签
              }
            }
          }
        },
        // 其他字段同理
      ]
    };
    
  3. 配置集合类型本身的显示名称:
    如果需要修改集合类型在侧边栏或顶部导航的显示名称,同样在Schema根节点添加pluginOptions:
    export default {
      kind: 'collectionType',
      name: 'article',
      pluginOptions: {
        contentManager: {
          collection: {
            label: '文章管理' // 集合类型的显示名称
          }
        }
      },
      // 其他配置...
    };
    

注意事项:

  • 修改Schema文件后,需重启Strapi服务使配置生效
  • 该配置属于代码的一部分,部署时随项目代码同步到新环境,不会丢失
  • 若之前通过UI修改过标签,Schema中的配置会覆盖UI的临时设置,确保环境一致性

内容的提问来源于stack exchange,提问作者donny.dee

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.11 21:42:34