WordPress Block Editor 上线前 QA 检查清单

WordPress 改版项目可能前台看起来已经完成，但真正维护网站的人仍然会遇到问题。上线后最常见的失败点在编辑器里：编辑找不到正确的 Pattern，可复用区块在移动端变形，自定义字段接受了错误值，或者客户复制了一个模块后不知不觉破坏了 SEO 输出。

这份清单适合自定义 WordPress 主题开发、Gutenberg 区块主题、支持 Block Editor 的传统主题、Advanced Custom Fields 布局、可复用 Pattern、多语言 WordPress 网站和维护项目。上线前、客户培训前，以及主题、插件或内容模型发生较大变化后，都应该跑一遍。

不要只打开首页来测试编辑器。先整理所有模板和可复用编辑单元。包括页面、文章、案例、落地页、资源页、服务页、归档模板、表单页、法律页面，以及所有自定义文章类型模板。

然后列出编辑可以接触到的每个区块、Pattern、同步 Pattern、ACF 区块、短代码、嵌入、表单模块、导航元素和主题控制模块。这份清单就是测试矩阵，也会变成后续交接文档。

• 把每个项目标记为锁定、可编辑、可复用、可复制、已弃用或仅开发者可改。
• 记录每个区块允许出现的位置：页面、文章、落地页、自定义文章类型或受限模板。
• 识别会影响 SEO 的区块，包括标题、FAQ、Schema 输出、图片字段、面包屑和内链。
• 标记依赖插件设置、API 数据、第三方嵌入或主题选项的区块。

示例内容会让编辑器看起来比真实情况简单。真实内容会有长标题、短标题、缺图、重复 CTA、尴尬换行、从文档复制的表格、粘贴格式、非英文姓名和不完整元数据。编辑器必须能承受这些内容，而不是只有 demo 状态好看。

QA 前准备一组小型测试内容。至少包括一个短页面、一个长页面、一个图片密集页面、一个表单页面、一个资源或文章页面，以及一个多语言页面，如果网站支持多语言。

• 测试很长的 H1、H2、按钮、卡片、Tab、折叠面板、面包屑和导航标签。
• 尝试缺失图片、竖图、透明 PNG、大图、小图和 alt text 修改。
• 从 Google Docs、Microsoft Word、邮件和表格里粘贴带格式内容。
• 检查选填字段为空时的状态，例如 caption、excerpt、副标题、价格、作者或链接缺失。

好的 WordPress 编辑体验，不是把所有控制项都交给编辑，而是给他们真正需要的控制，同时阻止会制造不一致页面的选择。QA 要同时确认两件事：足够灵活，以及有意设置的限制确实生效。

用编辑角色打开每个区块，不要只用管理员。检查哪些字段可见，哪些选项被限制，哪些样式可选，以及区块预览是否能让编辑在发布前理解最终效果。

• 确认颜色、间距、对齐、标题级别、图片比例、按钮样式和列控制都被有意限制。
• 检查必填字段、默认值、帮助文案、校验信息和兜底输出。
• 确保同步 Pattern 不会被错误角色意外拆分、覆盖或修改。
• 确认开发者专用设置不会出现在编辑器侧边栏。

编辑器预览有用，但它不是最终浏览器。每个重要区块都应该在编辑器预览、预览 URL 和已发布前台里测试桌面、平板和手机。尤其要关注图片、卡片、表单、轮播、折叠面板、Tab、吸顶元素和嵌入媒体组合在一起的区块。

一个简单规则很有效：如果区块会被客户重复使用，就要单独测试，也要放进真实页面里测试。很多布局问题只有当区块按设计稿之外的顺序叠加时才会出现。

• 检查 1440 px 桌面、1024 px 平板、768 px 平板、390 px 手机，以及一个更窄的手机宽度。
• 测试常见区块组合，例如 hero 加卡片、卡片加 FAQ、表单加推荐语、资源列表加分页。
• 确认 focus、hover、active、折叠展开、吸顶、弹窗等状态正常。
• 当编辑器预览和前台不同，以已发布预览作为最终验收依据。

编辑器 QA 应该保护技术 SEO 和无障碍，因为编辑上线后可以改变这两者。区块应该输出有效标题、有用的 alt text 字段、语义化按钮和链接、正确 canonical 行为、干净摘要，以及在需要时输出可预期的 Schema。

测试那些会喂给元数据的内容控制项。对很多 WordPress 项目来说，这包括 SEO 插件字段、摘要字段、自定义标题字段、Open Graph 图片、FAQ 区块、作者数据、自定义文章类型归档、面包屑和多语言关联字段。

• 确认页面仍然只有一个 H1，标题层级合理，链接可抓取，图片有 alt text，按钮标签可读。
• 检查 SEO title、meta description、canonical URL、Open Graph 图片、excerpt、slug 和可索引性控制。
• 只在内容真正支持时，验证 FAQ、Article、Breadcrumb、Product、LocalBusiness 或 Service Schema。
• 对折叠面板、Tab、表单、菜单、嵌入和弹窗做键盘导航与屏幕阅读器抽查。

一个区块编辑器设置对管理员可用，不代表对真实内容团队安全。要测试网站实际会用到的角色：管理员、编辑、作者、翻译、SEO 专员、市场经理、外部写手和客户审核人，如果这些角色存在的话。

上线前，工作流应该回答几个实际问题。谁能创建落地页？谁能编辑全局 Pattern？谁批准翻译？谁可以发布、定时、下线或恢复页面？草稿准备好后，谁会收到通知？

• 测试草稿、预览、定时发布、发布、下线、密码保护、恢复版本和复制页面流程。
• 确认受限角色不能误改导航、表单、SEO 关键设置、可复用 Pattern、主题选项或插件设置。
• 检查移动区块、修改 Pattern、自定义字段编辑和多语言更新后的版本记录。
• 在编辑开始修改正式内容前，确认 staging、production 和备份流程清楚。

最有效的 QA，是看真正的内容负责人使用编辑器。给他们一组短任务：创建一个服务页草稿，更新一个案例，替换图片，添加 CTA，编辑 FAQ，预览移动端，更新 SEO 字段，并提交页面审核。

不要立刻解释所有问题。观察他们在哪里停顿，哪些标签被误解，哪些控制项被错误使用。这些时刻会告诉你问题应该通过主题代码、字段标签、权限、文档还是培训来解决。

• 记录完成常见编辑任务需要多久，是否需要开发者帮助。
• 记下每个不清楚的字段标签、缺失的帮助文案、混乱的 Pattern 名称或高风险控制项。
• 让编辑故意犯一个错误，然后从版本记录或预览里恢复。
• 把演练记录整理成最终上线 punch list。