在 Sitecore XM Cloud 中设计可扩展内容架构

发布: (2026年1月1日 GMT+8 19:37)
8 min read
原文: Dev.to

Source: Dev.to

Sitecore XM Cloud 为现代网页而生。它是云原生、无头的,并且消除了许多基础设施的烦恼。但即使拥有这些优势,仍有一件事可能在以后导致大问题:糟糕的内容架构。

良好的内容架构不仅仅是模板的问题。它涉及内容在不同站点和渠道之间的结构、复用、管理和交付方式。若设计得当,它能帮助团队加快速度,并在业务需求变化时轻松适应。若设计不当,则会导致不断的返工和挫败感。

基于多年的经验,本文阐述了如何在 XM Cloud 中构建内容结构,使其在当下灵活,并在未来具备可扩展性。

“可扩展”在 XM Cloud 中到底意味着什么?

可扩展性不仅仅是性能。在 XM Cloud 中,可扩展的内容意味着:

  • 高效支持多个站点、语言和地区
  • 在渠道和品牌之间实现内容复用
  • 为通过 GraphQL/Experience Edge 交付保持清晰的 API
  • 让作者轻松管理内容
  • 确保系统在演进时无需昂贵的返工

可扩展的设置应让您在不一次又一次重建的情况下实现增长。

可扩展内容设计的核心原则

将结构与表现分离

XM Cloud 天生是无头的。内容的设计应独立于其呈现方式。

最佳实践

  • 避免在内容字段中嵌入布局或设计逻辑
  • 关注内容本身,而不是它的外观

这使得内容可以在网站、移动应用以及未来渠道之间复用。

使用组件构建内容

不要把所有内容放在一个大的页面模板中,而是将内容拆分为称为组件的更小块。

示例包括

  • Hero 区段
  • 文本块
  • 带说明的图片
  • 行动号召(Call to action)
  • 功能列表

每个组件

  • 目的明确
  • 可在多个位置复用
  • 可单独更改而不影响其他部分

在像 Next.js 这样的现代前端框架中,这种方式尤为有效。

战略性使用原子组件和复合组件

常见错误是只创建原子组件或只创建大型复合组件。

更佳做法

  • 原子组件 用于简单、可复用的元素(文本、图片、链接)
  • 复合组件 用于业务概念(定价区块、推荐语块)

在两者之间取得平衡,可减少重复,同时保持编辑简单。

Source:

可扩展的内容建模模式

模式 1 – 页面是容器,而非内容承载者

页面应主要充当容纳组件的容器。

避免

  • 包含大量业务特定字段的页面模板

首选

  • 仅包含标题和元数据等基础信息的简洁页面模板
  • 通过组件和数据源来管理实际内容

这样可以让页面在未来更容易复用和扩展。

模式 2 – 共享内容 vs. 本地内容

某些内容需要在各处复用,而其他内容则特定于某个页面或活动。

共享内容示例

  • 导航
  • 页脚
  • 产品详情
  • 法律文本

本地内容示例

  • 活动页面
  • 着陆页信息

将共享内容存放在明确的地点,并使用适当的权限进行保护,以避免意外更改。

模式 3 – 保持内容树整洁

杂乱的内容树会导致管理困难。

实用技巧

  • 按用途组织内容,而不是按页面组织
  • 使用文件夹来分类:
    • 组件
    • 数据源
    • 标签和分类
  • 不要将 URL 结构直接绑定到内容树

整洁的结构有助于编辑人员和开发人员。

为多个站点和地区设计

XM Cloud 对多站点设置非常好,但前提是内容模型支持它。

最佳实践包括

  • 为每个站点或地区设置独立的内容根目录
  • 尽可能共享全局内容
  • 明确处理语言和地区差异
  • 避免在模板中做仅适用于单一站点的假设

采用这种方法,添加新品牌或新国家会更加容易。

治理与长期维护

即使是最好的架构,没有规则也会失败。

良好的治理意味着

  • 限制谁可以创建或更改模板
  • 记录为何以特定方式设计内容模型
  • 使用清晰且一致的命名
  • 定期清理未使用的字段和模板

简单且受控的系统始终比复杂的系统更易扩展。

GraphQL 与性能

您的内容结构直接影响查询数据的难易程度和速度。

请记住

  • 不要创建非常深或复杂的引用
  • 保持组件轻量化
  • 重用 GraphQL 片段
  • 设计内容时要让查询清晰,而不仅仅是编辑方便

一个干净的 GraphQL API 通常意味着一个设计良好的内容模型。

常见错误需避免

  • 页面模板中充斥业务逻辑
  • 在许多模板中复制相同字段
  • 将设计规则存放在内容中
  • 为细微差别创建新模板
  • 忽视内容编辑者的实际工作方式

这些错误会拖慢团队进度,使系统难以维护。

为什么良好的内容架构很重要

  • 更快的网站上线
  • 随着时间推移,减少返工
  • 更容易与其他系统集成
  • 内容编辑者更满意
  • 更清晰、更简洁的前端代码

最重要的是,随着业务的增长,平台保持灵活。

结论

在 Sitecore XM Cloud 中设计可扩展的内容架构并非一次性任务——它是一项长期策略。通过关注可重用组件、清晰的结构、良好的治理以及无头原则,您可以构建能够随时间平稳增长的系统。

XM Cloud 为您提供了强大的工具,但真正决定成功的是您所设计的架构。

Back to Blog

相关文章

阅读更多 »

别再像2015年那样写API

我们已经进入2025年,仍有许多代码库把 API 视为简单的“返回 JSON 的端点”。如果你的 API 设计仍停留在基本的 CRUD 路由上,你正……

介绍 graphql-complexity-validation

✨ 特性 - 零运行时依赖 - 完全类型化的 TypeScript - 支持 fragments 与 inline fragments - 默认忽略 Introspection 适用于: - Apollo…