> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# SEO 与元信息

> 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 杂项设置 → SEO 设置

主题输出的搜索引擎与社交分享元信息。默认开启，绝大多数站点不需要改动。

## 配置项

| 选项                   | 默认值 | 说明                                             |
| -------------------- | --- | ---------------------------------------------- |
| 输出 canonical 与社交分享标签 | 开启  | 控制 `<link rel="canonical">` 与 Open Graph 标签的输出 |

## 输出内容说明

开启后，主题会在页面 `<head>` 中输出：

| 标签                | 作用                   | 覆盖页面             |
| ----------------- | -------------------- | ---------------- |
| `canonical`       | 告诉搜索引擎哪个是原始地址，避免重复收录 | 文章、独立页面、六个自定义模板页 |
| Open Graph / 社交分享 | 分享到社交平台时展示的标题、描述、封面  | 同上               |
| 首页描述              | 首页在搜索结果中的摘要          | 首页               |

站点图标（favicon）由 Halo 统一注入，主题不再重复输出。

## 推荐配法

**默认即可**：开启，交给主题与 Halo 配合输出。绝大多数站点的最佳选择。

**已用 SEO 插件**：如果某个插件已经输出 canonical 或 OG 标签，关闭本项，避免同一页面出现两份标签。

**多域名 / 镜像站**：保持开启，同时把主域名填进 Halo 的站点地址，canonical 会跟随站点地址生成。

## 注意事项

- 关闭后**不会**删除已收录的页面，只是不再输出新的 canonical 与 OG 标签
- 分享卡片缺少封面通常不是这里的开关问题，而是文章没有填写封面
- 首页描述由 Halo 的 SEO 设置提供，主题不再重复输出，避免两段描述同时出现
- 若部署在子目录或绑定了多域名，canonical 以 Halo 的「站点地址」为准，改域名后记得同步
- 检测方式：查看页面源码搜索 `canonical` / `og:title`，或使用任意 SEO 检测工具