Wagtail Django CMS 结构化内容平台

要解决的问题

当内容运营团队和开发团队共用一套系统时，最大的摩擦往往出在「内容结构」上：营销页面要突出的字段不同，新闻文章要维护摘要和封面，产品页又有规格表。如果所有页面都靠自由文本和模板硬编码，结果就是字段散落、格式失控，编辑改一处内容要来回确认位置。

这类场景的共同需求是：字段级结构化、编辑流程可控、展示层可替换。Wagtail 正是为这类需求设计的。

核心能力

• 灵活的页面模型：用 Django model 定义页面字段，title、intro_text、cover_image 都成为一等公民，编辑在后台按字段录入，而不是对着富文本框猜测格式。
• 流式块编辑（StreamField）：正文内容按块组织，段落、图片、嵌入媒体各自有明确类型，前端渲染时也能按块逐个处理。
• Headless 与经典模式并存：既可作为传统 Django 应用渲染模板，也可通过 content API 把数据输出给 Vue/React 前端，一次建模两种用法。
• 图片与媒体管线：内置图片裁剪、格式转换（如 WebP 输出）和集中管理，不用额外接第三方工具。
• 搜索与多站点：自带搜索后端（可切换 Elasticsearch），多站点模式下一套代码库管理多个站点的内容。

适用边界与注意点

• 这是面向工程团队的 CMS，前提是你已熟悉 Django。模型迁移、权限组、模板继承这些决策仍然由开发侧完成。
• 如果你只需要一个零代码的后台，Wagtail 的定制成本反而偏高；反之，如果内容结构需要强约束和可扩展，它的模型层比纯 WordPress 式方案清晰得多。
• Headless 使用时注意 API 端点的缓存策略，内容更新到前端展示之间的延迟需要自行处理。