WordPress 区块样式库检查清单：主题开发前先做

WordPress 区块样式库，是自定义主题和可维护网站之间的桥梁。它能让编辑用可复用页面模块搭建服务页、落地页、资源中心、案例页和活动页面，而不是每次都让开发重复写同一种版式。

风险在于，很多团队太晚才规划 pattern。页面已经设计得很精致，开发已经开始，最后才回头抽出可复用模块。结果通常是 pattern 很脆弱，编辑控件不清楚，SEO 字段薄弱，真实内容一变长版式就坏。

这份清单适合在 WordPress 主题开发、网站改版或 CMS 重建前使用。目标是定义一套可复用的编辑模块，同时保护版式质量、搜索可见性、无障碍体验和交付后的稳定性。

先从上线后真实要维护的页面开始。B2B 服务网站的 pattern library，和媒体站、本地商家、电商支持中心、多语言资源中心都不一样。真正有用的库来自发布工作，而不是抽象组件名。

列出每种页面类型，以及里面反复出现的 section。比如服务页可能需要证据模块、流程步骤、FAQ、相关资源和咨询 CTA。案例页可能需要结果摘要、挑战说明、图片组和客户评价。

• 列出上线页面类型：首页、服务页、落地页、案例页、博客、资源中心、地区页和法律页面。
• 标记哪些 section 需要编辑自行添加、删除、排序或复用。
• 把重复需求整理成候选 pattern，例如 proof strip、feature grid、process steps、FAQ、CTA band、comparison row 和 resource cards。
• 识别应该锁在 template 里的结构，避免编辑修改核心页面骨架。
• 把一次性活动 section 单独列出，避免污染核心样式库。

不是所有可复用界面都应该用同一种 WordPress 能力实现。Block patterns 适合由核心区块或自定义区块组成的可复用版式。Templates 更适合需要固定结构的页面。Custom blocks 适合需要受控字段、数据源、校验或动态渲染的模块。

开发开始前先做这个判断。这样主题架构更干净，编辑也更容易理解内容应该放在哪里。

• 用 block patterns 处理编辑可以插入和微调的可复用内容 section。
• 用 locked templates 固定文章详情、服务页外壳和归档页等结构。
• 当 section 需要严格字段、重复项、API 数据、条件渲染或业务逻辑时，使用 custom blocks。
• 当内容是结构化数据而不是单页 section 时，考虑自定义文章类型或字段。
• 记录哪些内容可以安全编辑，哪些被锁定，哪些必须由开发调整。

Patterns 应该让编辑更快发布，而不是把每个页面变成空白画布。好的保护规则能让 CMS 既灵活，又不破坏品牌、间距、层级和移动端布局。

这些规则要写得具体。编辑需要知道标题长度、图片比例、CTA 行为、可选字段、兜底状态，以及什么时候不应该使用某个 pattern。

• 定义标题层级，避免编辑用 pattern 造成混乱的 H1 或 H2 结构。
• 设置图片比例、最小尺寸、焦点规则和 alt text 要求。
• 限制每个 pattern 的 CTA 数量、文案长度和链接目标。
• 为可选图片、标签、数据、引用和相关内容规划空状态。
• 批准 pattern 前，测试长名称、翻译文案、缺失图片和过多卡片。

WordPress pattern library 可以通过一致的内容结构支持 SEO；也可能因为编辑复制薄内容、跳过有用标题、把重要文案藏进图片，或发布没有内链的页面而拖累 SEO。

每个重要 pattern 都要先决定用户和搜索引擎在渲染页面里应该看到什么。服务页和落地页 pattern 通常需要清晰标题、描述性正文、相关资源、FAQ、schema 可用内容，以及通往下一步页面的链接。

• 定义哪些 pattern 可以包含 H2 或 H3，哪些只能作为辅助内容。
• 在合适位置加入相关服务、案例、资源、联系页或定价页的内链槽位。
• 只有当可见内容支持时，才规划 FAQ、testimonial、review、product、organization 或 breadcrumb schema。
• 避免用图片文字承载重要关键词或转化文案。
• 检查 pattern 内容是否出现在渲染 HTML、搜索摘要、Open Graph 预览和 XML sitemap 路由中。

Pattern 不是在一个桌面设计稿里好看就算完成。它需要经得住手机、平板、键盘操作、屏幕阅读器、大字号、慢图片加载和真实编辑错误。

先在 pattern 层面做 QA，再用它批量搭页面。一个间距、图片加载或标题问题，在库里修一次，比上线后在每个页面里返工便宜得多。

• 在手机、平板、笔记本和宽屏桌面宽度测试每个 pattern。
• 检查键盘焦点顺序、可见焦点样式、链接目的、按钮标签和颜色对比度。
• 确认 lazy loading、图片尺寸、响应式资源和布局稳定性处理一致。
• 把多个 patterns 连续堆叠到同一页面，检查间距冲突和重复 CTA 疲劳。
• 使用真实复杂内容测试，包括长翻译、短标题、缺失图片和不均匀卡片数量。

如果网站是多语言，pattern library 在内容录入前就需要本地化规则。英文里成立的 section，换成中文可能溢出，可能需要不同内链，也可能涉及不同市场的声明和合规文案。

即使只有一种语言，治理也很重要。编辑要知道谁可以创建新 pattern，谁可以修改可复用 pattern，以及什么时候页面专属变化应该进入共享样式库。

• 标记哪些 pattern 支持直接翻译，哪些需要市场特定版本。
• 检查本地化 URL、内链、alt text、CTA 文案、单位和法律声明。
• 决定谁可以编辑 synced patterns、detached copies、template parts 和 custom block defaults。
• 建立命名规则，让编辑不用读开发说明也能找到正确 pattern。
• 上线后第一个月复查样式库，合并重复项并删除容易误用的选项。