术语表

永久链接(permalink)

已发布资源或已渲染页面的绝对 URL,包含协议与主机。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 分清 permalink 与 relpermalink 各自该用在哪里,并知道对外地址出错时先检查 baseURL

接着读:永久链接配置

永久链接(permalink)是已发布资源或已渲染页面的绝对 URL,包含协议和主机。

为什么重要

RSS、sitemap、canonical 链接和 og:url 这类交给外部系统读取的地方必须用绝对 URL,也就都会用 permalink,因此 baseURL 写错会一次性污染所有对外地址——本地预览时它还会是 http://localhost:1313。 站内页面互链则应该用相对地址(.RelPermalink),否则换域名或部署到子路径时又要全站改一遍;两者混用是「本地正常、上线后链接全错」的常见来源。

延伸阅读:Permalink 方法 · 永久链接配置