分析与 SEO
主题默认不加载任何分析、表单或广告脚本，不配置就没有对外请求。接入需要显式配置，并把这条外部数据边界写进站点的隐私说明。SEO 一侧相反：canonical、hreflang、robots meta、Open Graph 与 Twitter 卡片由主题逐页生成，需要你做的是把 baseURL 与每页的 description 写对。
接 Google Analytics
用 Hugo 内置的服务配置，填 GA4 的 measurement ID：
主题只在 production 环境渲染这段脚本（hugo 构建默认 production，hugo server 默认 development）。本地预览与预览部署因此不上报数据，不需要另加开关。
不要同时设置已经弃用的顶层 googleAnalytics 键。不需要分析时删掉整段配置，不要填一个假 ID。
配上之后，页面浏览量与事件会发给 Google。严格的同源内容安全策略也需要为它放行，见内容安全策略。这是站点决策，不是主题默认。
接其它分析服务
Plausible、Umami、Matomo 这类服务只要求插入一段脚本。主题提供两个注入点，在站点仓库里建同名文件即可，不用改主题：
hugo.IsProduction 这一层不要省：没有它，每个人的本地预览都会向你的统计上报数据。
这是有意的：cookie 同意脚本必须先于分析脚本运行，才能真正拦住它。
「这篇文档解决了你的问题吗」反馈组件是另一件事：默认关闭，不发网络请求，配置见仓库与页面信息。
页面描述
<meta name="description"> 按这个顺序取值，取到第一个非空的就停：
- 页面 front matter 的
description - Hugo 计算出的页面摘要（
.Summary） - 站点配置里的
params.description
每页写一句 description 是唯一需要作者做的 SEO 动作。它同时用于三处：搜索引擎的摘要、栏目首页的卡片副标题、站内搜索的结果预览。
多语言站点要给每种语言各写一句，不要把英文描述抄到中文页上。站点级默认值也是分语言的：
canonical 与 hreflang
主题为每个页面输出一条 canonical 和一组 hreflang 备用链接，不需要配置：
hreflang 的语言代码来自各语言的 locale（本站是 en-US / zh-CN），链接来自 Hugo 的译文关系。上面英文那一条指向站点首页而不是对应的英文页：本页没有英文对等文件，Hugo 找不到译文时回退到目标语言首页。这是预期行为，也可以用来判断译文关系有没有被 Hugo 认出来。
canonical 由 baseURL 拼出。baseURL 配错时 canonical 会把搜索引擎指向不存在的地址，比构建失败更难发现。上线前照发布上线的验收清单查一遍。
多语言的完整配置在多语言。
社交卡片
主题调用 Hugo 内置的 Open Graph 与 Twitter 卡片模板，标题、描述、URL、语言、站名都是自动的：
要让分享出去的链接带图，在 front matter 里给 images：
给全站一张兜底图就把同样的键写进 params：
有图时 twitter:card 从 summary 变成 summary_large_image，并多出 og:image 与 twitter:image 两条。本站两处都没有设置，上面的渲染结果里因此看不到图片相关的标签。
站点地图
Hugo 自动生成，多语言站点生成的是一个索引：
站点级默认值和页面级覆盖都是 Hugo 原生的：
changefreq 与 priority 是提示不是承诺，搜索引擎可以忽略。值得做的是发布前确认草稿、私有内容与非规范副本没有进入站点地图，并且每种语言的那份都生成了。
robots.txt 与不收录
Hugo 只在站点配置里打开开关时才生成 robots.txt：
主题提供的模板按构建环境给出两种结果，不需要你写内容：
页面里的 robots meta 跟着同一个开关走：production 且不是打印输出时是 index, follow，否则是 noindex, nofollow。预览部署不要用 --environment production 构建，非 production 自带不收录的行为。
主题没有按页 noindex 的开关。某一页不该被收录时，可靠的做法是不发布它（draft: true，或用 Hugo 的 _build 选项）。既要发布又不想被收录，就用 head-end.html 钩子自己输出；主题已经输出了一条 robots meta，两条同时存在时如何合并由搜索引擎决定。
收录检查
上线一两周后，按这个顺序确认搜索引擎看到的东西和你以为的一致：
- 抓取权限：访问
<baseURL>/robots.txt，确认是Allow: /而不是Disallow: /。 - 页面清单：访问
<baseURL>/sitemap.xml，点进语言子地图，看页面数量对不对。 - 收录数量：在搜索引擎里查
site:你的域名，数量级对得上就行，不必逐页核对。 - 规范地址：搜索结果应当落在 canonical 指向的 URL 上，而不是带
?参数或旧域名的版本。 - 主动提交：在 Google Search Console / Bing Webmaster Tools 里加上站点并提交
sitemap.xml的地址，比等着被爬快。
搜索元数据补不了内容本身的问题：单薄、重复、过时的页面，写再好的 description 也一样。
验证
在产物里查这几项：
浏览器里再确认一次：打开一个代表性页面，看开发者工具的网络面板，没接分析的站点不应有指向第三方域名的请求。
相关
- 发布上线 —
baseURL、验收清单与预览部署不被收录 - 仓库与页面信息 — 页面反馈组件、编辑本页与最后修改时间
- 多语言 — 语言配置决定
hreflang与译文关系 - Agent 支持 — 给大模型看的
.md输出与llms.txt - 配置总览 —
services、sitemap、enableRobotsTXT等键的定义