Twitter 卡片验证工具

当有人在 X(Twitter)上分享你的链接时,平台会读取网页的 twitter: 元标签来构建预览卡片:它的版式、标题、描述、图片和来源署名。如果缺少这些标签,链接就会以没有卡片的纯 URL 形式发布。把网页 HTML 粘贴到下方,本工具会检查三个必需标签 twitter:card、twitter:title 和 twitter:description 是否存在,并显示它从每个标签读取到的值,让你在发布前修好损坏的预览。

如何验证你的卡片

  1. 1

    粘贴网页 HTML

    你可以只粘贴 `<head>` 部分,也可以粘贴整个文档。工具只检查 `<meta>` 标签,因此会忽略其他所有标记。

  2. 2

    它查找三个必需标签

    `twitter:card`、`twitter:title` 和 `twitter:description`,这是任何卡片类型都需要的最低要求。`twitter:image` 等其他标签不在此处检查。

  3. 3

    查看找到了什么

    每个匹配的标签都会连同从其 `content` 属性读取到的值一起列出,方便你快速核对文案。

  4. 4

    修补缺失的部分

    三个标签中缺少的任何一个都会被标记为缺失。把它添加到你的 `<head>` 中,然后重新粘贴 HTML 再次检查。

X(Twitter)卡片的四种类型

版式由 twitter:card 的值决定。本工具会读取你填入的值;X 支持的四种类型如下:

卡片类型 twitter:card 值 典型用途
摘要 summary 文章和常规内容页
大图摘要 summary_large_image 带主图的博客文章
播放器 player 内嵌的音频或视频
应用 app 带商店元数据的应用安装链接

必需标签与推荐标签

本工具只检查第一组,也就是 X 为任何卡片都需要的三个标签。

必需(在此检查):

  • twitter:card,要使用的版式
  • twitter:title,标题(X 大约显示前 70 个字符)
  • twitter:description,摘要(X 大约显示前 200 个字符)

推荐(此处不检查,但值得添加):

  • twitter:image,指向 PNG、JPG 或 GIF 的绝对 https:// URL;摘要卡片至少 300 x 157 像素,summary_large_image 为 800 x 418 像素
  • twitter:site,你品牌的 @handle
  • twitter:creator,作者的 @handle
  • twitter:image:alt,用于无障碍的替代文本

常见错误

  • 只有 Open Graph 标签。 X 会回退到 og:title、og:description 和 og:image,所以链接仍会展开,但没有 twitter:card 时版式默认是小尺寸摘要。可以的话就把两组都放上。
  • 图片太小。 低于 300 x 157 像素时,卡片可能会缩成纯文本。
  • 相对路径的图片 URL。 twitter:image 必须是绝对地址(https://...);相对路径会被忽略。
  • 用 property= 而不是 name=。 X 和本工具都是从 name="twitter:..." 读取 Twitter 标签。写成 property="twitter:..." 对 Open Graph 有效,但对这些标签无效。
  • 描述太长。 超过约 200 个字符后 X 会截断,通常从词语中间截断。

如何查看真实卡片

X 已于 2023 年停用官方的 Card Validator(cards-dev.twitter.com/validator),因此不再有官方页面能渲染实时预览。本工具确认必需标签存在且可读取;若要查看真实卡片,请把链接分享到帖子草稿或发给自己的私信中,或使用第三方的链接预览检查工具。如果修好标签后 X 仍显示旧图片,请在图片 URL 后加上像 ?v=2 这样的查询字符串来绕过缓存。

常见问题

不会。它读取你粘贴的 HTML,确认三个必需的 twitter: 标签存在,并显示每个标签的值。它不会绘制卡片,也不会抓取你的线上页面。X 已于 2023 年关闭自家的 Card Validator,因此查看真实卡片的可靠方式,是把链接分享到帖子草稿或发给自己的私信中。

X 会回退到 og:title、og:description 和 og:image,所以链接仍会展开,但没有 twitter:card 时版式默认是小尺寸摘要。想要大图卡片,就必须把 twitter:card 明确设为 summary_large_image。请注意,本工具只检查 twitter: 标签,不检查你的 og: 标签。

它查找 name="twitter:...",且 content 属性写在名称之后,可用单引号或双引号。如果你的标签用的是 property="twitter:..." 而不是 name=,或者把 content 放在 name 前面,即使 HTML 有效,模式也不会匹配。请调整为 name="..." content="..." 的顺序,然后再次检查。

本工具识别名称时不区分大小写,所以 twitter:Card 在这里也能被检测到。不过还是请用小写(twitter:card),因为这是 X 在文档中规定并期望的写法。

简单说:会。检查在我们的服务器上运行,所以你粘贴的 HTML 会被发送到那里,经过扫描后丢弃。我们只保留一条匿名记录,表明该工具被使用过,绝不保存你的标记,而且它不是在浏览器中运行的离线工具。

相关工具

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