站点地图配置
通过 sitemap 配置站点地图的字段、文件名与开关。
这一页解决什么问题
站点地图(sitemap.xml)告诉搜索引擎有哪些页面可抓,以及各页面的更新频率与相对优先级。这一页只有四个键,但有一个必须记住的细节:默认值表示「不输出该字段」——changefreq 的默认 "" 与 priority 的默认 -1 都不是「空值」或「最低优先级」,而是干脆不写进 XML。
什么时候需要这些设置
| 设置 | 什么时候需要 | 改错了会看到什么现象 |
|---|---|---|
changefreq / priority |
站点内容丰富,想给搜索引擎一点抓取提示 | priority 只接受 0.0–1.0,越界值在协议层面无效,搜索引擎会忽略该字段 |
disable |
某些页面(隐私页、示例页)不该出现在站点地图里 | 只想排除一页却写在站点级 → 整站地图被关掉(或反过来,一页都没排除) |
filename |
托管平台要求站点地图用别的文件名 | 改名后 robots.txt 中的 Sitemap: 指向没同步 → 搜索引擎找不到地图 |
实测(Hugo 0.167,本站):本站 hugo.toml 设置了 [sitemap] changefreq = "weekly" 与 priority = 0.5,hugo config 输出的 [sitemap] 段中可以看到这两项生效。
以下是站点地图的默认配置值。除非在 front matter 中被覆盖,它们会作用于所有页面。
字段
| 键名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
changefreq |
string |
"" |
页面可能发生变化的频率。有效值为 always、hourly、daily、weekly、monthly、yearly、never。使用默认值 "" 时,Hugo 会从站点地图中省略该字段。 |
disable |
bool |
false |
是否禁止把页面纳入站点地图。在 front matter 中设为 true 可排除该页面。 |
filename |
string |
sitemap.xml |
生成文件的名称。 |
priority |
float |
-1 |
该页面相对于站点上其他页面的优先级,有效值范围为 0.0 到 1.0。使用默认值 -1 时,Hugo 会从站点地图中省略该字段。 |
changefreq 与 priority 的取值含义参见 sitemaps.org 协议,两者的默认值都表示“不输出该字段”,而不是输出空值。
示例
站点级默认配置:
toml
[sitemap]
changefreq = 'weekly'
disable = false
filename = 'sitemap.xml'
priority = 0.5在单个页面的 front matter 中覆盖默认值:
yaml
title: 示例页面
sitemap:
changefreq: daily
priority: 0.8把某个页面排除出站点地图:
yaml
title: 不应出现在站点地图中的页面
sitemap:
disable: true站点地图的输出仍然使用模板目录中的站点地图模板,因此如需调整 XML 结构,可以覆盖内置模板。
常见坑
| 症状 | 真因 | 怎么修 |
|---|---|---|
XML 里整段 <changefreq> / <priority> 缺失 |
默认值("" 与 -1)的含义就是「省略该字段」 |
显式设值,例如 changefreq = 'weekly'、priority = 0.5 |
| 某页面不该出现却出现了 | 只在站点配置里设了默认值,没在该页 front matter 写 sitemap.disable |
在该页 front matter 中写 sitemap: {disable: true},格式与所用 front matter 语法一致 |
| 站点地图存在,搜索引擎却没抓 | robots.txt 中没有指向地图的 Sitemap: 行 |
补上该行,或启用 enableRobotsTXT 让 Hugo 输出内置的 robots.txt |
| 改了字段但产物没变 | 改错了层级:站点默认值在 hugo.toml 的 [sitemap],单页覆盖在该页 front matter |
用 hugo config 确认站点级取值,再检查该页 front matter 是否覆盖了它 |
更多排查入口见故障排查。