Softonic

修复面包屑结构化数据 position 错误

步 1 / 2

每行一项：名称 | URL

下一步：结果

测试工具常会提示面包屑标记需要 position 字段的值。最简单的解决办法，是重新生成列表，让每个 ListItem 都有连续的 position。在下方输入你的路径，编号由生成器完成。

用正确的 position 重建列表

  1. 1

    从旧标记中取出各级

    从有问题的代码块里取出每个名称和 URL，按顺序写成“名称 | URL”的行。

  2. 2

    删除不完整的行

    确保每一行都同时有名称和 URL，缺少任一项的行会被工具跳过。

  3. 3

    生成

    进入结果页。position 从 1 开始，每多一级加 1。

  4. 4

    替换旧代码块

    从页面中删除有问题的 script，粘贴新的代码块，然后再次测试。

为什么会出现 position 错误

BreadcrumbList 中的每个 ListItem 都需要一个 position，即表示其在路径中位置的整数。错误通常由以下原因之一造成：

  • 一个或多个条目缺少 position 键。
  • position 被写成文本，或者留空。
  • 数字重复，例如两个条目都是 2。
  • 数字跳号，例如 1、2、4。
  • 手动或由模板增加了层级，但计数没有更新。

工具的不同之处

生成器从不要求你输入 position。它从上到下读取各行，给同时有名称和 URL 的行依次分配 1、2、3……被跳过的行不会留下空缺，因此编号始终连续。

错误列表与重建列表的示例

交给验证器的有问题的输入：条目的 position 为 1、2 和 4，缺少 3。

用工具重建时输入：

首页 | https://example.com/
文档 | https://example.com/docs/
安装 | https://example.com/docs/setup/

输出的 position 为 1、2、3。

替换标记之后

  1. 把旧的 script 代码块完整删除，避免页面上同时存在两个冲突的列表。
  2. 粘贴新的代码块。
  3. 再次测试线上 URL。

如果错误仍然存在

检查是否有被你忘记的主题、插件或模板输出了第二个 BreadcrumbList。工具只会生成你从中复制的那段代码，别处生成的残留必须从源头清除。另外，请确认每个 URL 都完整，名称也没有为空。

对任何面包屑标记都适用的快速自查

再次测试之前，检查代码块的四件事：每个 ListItem 都有 position，position 按 1、2、3 排列且不重复，每个 ListItem 都有 name，每个 ListItem 都有 URL。四项都满足，position 错误就应该不会再出现。用普通列表生成代码块是最快的保证办法，因为这样就不会再手误写错编号。

常见问题

标准的序列从 1 开始，这个工具也是这样写的。

名称和 URL 不全的行会被跳过。请在竖线的前面或后面补上缺少的部分。

不必。它只反映你列出的路径中各级的先后顺序。

不安全。验证器把该字段视为必填，所以必须包含。工具会自动写入。

相关工具

UTM 链接构建器

使用 UTM 的 source、medium、campaign、term 和 content 参数构建活动跟踪 URL。生成干净、经过 URL 编码的链接，可直接用于广告和电子邮件通讯。

结构化数据标记验证器

粘贴一段 JSON-LD，即刻检查它能否正确解析，并包含 Schema.org 的核心键：@context、@type 以及 name 或 headline，在发布之前完成检查。

站点地图生成器

粘贴你的网址列表，生成带 changefreq、priority 和可选 lastmod 的有效 XML 站点地图，随时保存并提交到 Search Console。

元标签分析器

审计任意URL的元标签，检测缺失标签、长度异常、Open Graph/Twitter值冲突以及机器人指令配置错误等问题。

安全响应头分析器

粘贴你的 HTTP 响应头，即可获得关于关键安全响应头的优先级建议：Content-Security-Policy、Strict-Transport-Security、X-Frame-Options、Referrer-Policy 等。

SERP 预览

在发布前预览谷歌搜索结果。实时字符计数器会提示过长的标题和元描述，谷歌风格的摘要则展示你的结果实际呈现的样子。

此工具还提供其他语言版本

使用指南与应用场景