使用Hugo Ananke主题时URL路径不一致问题咨询

一、featured_image与正文链接路径表现不同的原因 #

Ananke主题对featured_image字段做了模板层面的特殊处理——它会调用Hugo的relURL或absURL函数，自动拼接你配置的baseURL。比如你设置的baseURL是https://username.github.io/myblog，/images/myimage.jpg会被处理成https://username.github.io/myblog/images/myimage.jpg。

而正文里的原生Markdown链接[my image](/images/myimage.jpg)，Hugo默认不会对这类根路径做额外拼接，会直接解析为域名根目录下的路径，也就是https://username.github.io/images/myimage.jpg，自然无法加载到myblog子目录下的资源。

二、解决站点迁移时批量修改路径的麻烦 #

有三种实用方案：

• 开启相对URL模式：在config.yaml中添加relativeURLs: true，所有根路径都会被转换为相对当前页面的路径，迁移时只改baseURL即可，不用动任何文章链接。
• 用自定义短代码替代原生链接：在layouts/shortcodes/目录下新建img.html文件，内容如下：

  <img src="{{ .Get "src" | relURL }}" alt="{{ .Get "alt" }}" />
  

  之后正文引用图片就用{{< img src="/images/myimage.jpg" alt="my image" >}}，短代码会自动结合baseURL生成正确路径，迁移零成本。
• 批量替换现有链接：如果已有大量内容，用全局替换工具（比如VS Code全局搜索替换），把所有![](/images/替换成![]({{< relURL "/images/" >}}，或者把[](/images/替换成[]({{< relURL "/images/" >}}，一次性修正路径。

三、实现文章与媒体文件同目录的结构 #

用Hugo的**Page Bundles（页面捆绑包）**就能实现：

1. 将单篇文章的.md文件改为目录形式，比如原content/posts/my-first-post.md，改成content/posts/my-first-post/index.md；
2. 把该文章的图片直接放到my-first-post目录下，结构如下：

   content/posts/
   ├── my-first-post/
   │   ├── index.md
   │   └── myimage.jpg
   

3. 之后在文章里引用图片直接写![my image](myimage.jpg)，featured_image字段写featured_image: myimage.jpg即可，Hugo会自动识别并生成正确资源路径。

这种结构彻底解决了路径依赖问题，迁移时直接移动整个文章目录就行，还能让文章和配套媒体的管理更清晰。

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