如何在Hugo中正确配置规范URL（Canonical URL）？

你的代码问题分析 #

1. 参数调用错误：你在代码里用了{{ .Params.baseURL }}，但.Params指向单篇页面的前置参数，并非站点配置里的全局参数。你在config.toml的[params]下定义的canonicalUrl需要用{{ .Site.Params.canonicalUrl }}调用，或者直接使用Hugo内置的{{ .Site.BaseURL }}（因为你已经在config里设置了baseURL = 'https://example.com/'）。
2. 本地开发的URL特性：Hugo在本地运行hugo server时，默认会把baseURL替换为http://localhost:1313/，所以直接用{{ .Permalink }}会输出本地地址，这是正常的开发行为，生产构建时会自动使用config里的正式baseURL。

修正后的head.html代码 #

替换你现有的layouts\partials\docs\inject\head.html内容为：

{{- if isset .Params "canonical" -}}
  <link rel="canonical" href="{{ .Params.canonical }}" />
{{- else -}}
  <link rel="canonical" href="{{ .Site.BaseURL }}{{ .RelPermalink }}" />
{{- end }}

• 逻辑说明：
  • 如果某篇页面的前置参数（front matter）里设置了canonical: "https://example.com/custom-url/"，就使用这个自定义地址
  • 否则，自动拼接站点baseURL和页面的相对路径，生成规范URL

本地测试正确URL的方法 #

如果想在本地开发时看到正确的规范URL，启动Hugo时指定--baseURL参数：

hugo server --baseURL https://example.com/

生产构建注意事项 #

执行生产构建命令时，Hugo会自动使用config.toml里配置的baseURL，无需额外参数：

hugo

这样构建后的页面就会输出你期望的https://example.com/docs/hello/作为规范URL。

内容的提问来源于stack exchange，提问作者ilhan