fixing-metadata

工作流

1. 找出元数据缺失或有误的页面（标题、描述、canonical、OG 标签）
2. 对照下方的优先级规则进行审核——优先修复关键问题（重复项、索引）
3. 确保标题、描述、canonical 和 og:url 彼此一致
4. 使用真实 URL（而非 localhost）验证社交卡片是否正确呈现
5. 将差异控制在最小范围内，且仅涉及元数据——不要重构无关代码

适用情形

在以下情况下参考这些指南：

• 添加或修改页面标题、描述、canonical、robots
• 实现 Open Graph 或 Twitter 卡片元数据
• 设置 favicon、应用图标、manifest、theme-color
• 构建共享 SEO 组件或布局元数据默认值
• 添加结构化数据（JSON-LD）
• 更改语言区域、备用语言或 canonical 路由
• 发布新页面、营销页面或可分享链接

规则类别及优先级

优先级	类别	影响
1	正确性与重复项	关键
2	标题与描述	高
3	canonical 与索引	高
4	社交卡片	高
5	图标与 manifest	中
6	结构化数据	中
7	语言区域与备用项	低至中
8	工具边界	关键

快速参考

1. 正确性与重复项（关键）

• 每个页面只在一个位置定义元数据，避免多个系统相互冲突
• 不要输出重复的标题、描述、canonical 或 robots 标签
• 元数据必须是确定性的，不得包含随机或不稳定的值
• 对任何用户生成或动态字符串进行转义和清理
• 每个页面都必须为标题和描述设置安全的默认值

2. 标题与描述（高）

• 每个页面都必须有标题
• 整个网站使用一致的标题格式
• 标题应简短易读，避免堆砌关键词
• 可分享或可搜索的页面应设置 meta description
• 描述必须是纯文本，不得包含 Markdown 或大量引号

3. canonical 与索引（高）

• canonical 必须指向该页面的首选 URL
• 仅对私有、重复或非公开页面使用 noindex
• robots 元数据必须符合实际的访问意图
• 如有可能，预览页或暂存页默认应设为 noindex
• 分页页面必须采用正确的 canonical 处理方式

4. 社交卡片（高）

• 可分享的页面必须设置 Open Graph 标题、描述和图片
• Open Graph 和 Twitter 图片必须使用绝对 URL
• 优先使用尺寸合适且宽高比稳定的图片
• og:url 必须与 canonical URL 一致
• 使用合理的 og:type，通常为 website 或 article
• 合理设置 twitter:card，默认使用 summary_large_image

5. 图标与 manifest（中）

• 至少包含一个能在各浏览器中正常使用的 favicon
• 适用时包含 apple-touch-icon
• manifest 必须有效，并在使用时添加引用
• 有意设置 theme-color，避免 UI 外观不一致
• 图标路径应保持稳定且可缓存

6. 结构化数据（中）

• 除非 JSON-LD 与实际页面内容明确对应，否则不要添加
• JSON-LD 必须有效，并反映实际呈现的内容
• 不要虚构评分、评论、价格或组织信息
• 除非有需要，否则每个页面优先使用一个结构化数据块

7. 语言区域与备用项（低至中）

• 正确设置 html lang 属性
• 存在本地化内容时设置 og:locale
• 仅在页面确实存在时添加 hreflang 备用项
• 本地化页面必须按语言区域正确设置 canonical

8. 工具边界（关键）

• 优先采用最小改动，不要重构无关代码
• 除非收到请求，否则不要迁移框架或 SEO 库
• 遵循项目现有的元数据模式（Next.js metadata API、react-helmet、手动 head 等）

审核指南

• 优先修复关键问题（重复项、规范链接、索引）
• 确保标题、描述、规范链接和 og:url 保持一致
• 在真实 URL 上验证社交卡片，而不是 localhost
• 优先采用稳定、简洁的元数据，避免花哨或动态内容
• 保持差异最小，仅限于元数据