Hugo 部署到 Vercel 只显示 index.xml

把 Hugo 博客部署到 Vercel，结果访问网站只显示 index.xml 的内容。

问题现象

部署日志里一堆警告，没有报错：

18:17:06.313 Installing Hugo version 0.58.2
18:17:24.069 Building sites … 
WARN 2025/12/16 10:17:24 found no layout file for "HTML" for "home"
WARN 2025/12/16 10:17:24 found no layout file for "HTML" for "section"
WARN 2025/12/16 10:17:24 found no layout file for "HTML" for "page"

构建统计显示：

  Pages            |  6  
  Paginator pages  |  0  
  Non-page files   |  0  
  Static files     |  2  
  Processed images |  0  
  Aliases          |  0  
  Sitemaps         |  1  
  Cleaned          |  0  

Total in 12 ms

Static files 只有 2 个，但构建只花了 12 毫秒，一堆找不到布局文件的警告。根本就是没有正常 build 嘛，导致访问网站就只有 RSS 订阅源。

问题根源

关键是 Log 中的这行：

18:17:06.313 Installing Hugo version 0.58.2

Vercel 默认是 Hugo 0.58.2，而我本地是最新的 0.152.2。

解决方案

在项目根目录的 vercel.json 中明确指定 Hugo 版本¹：

{
  "build": {
    "env": {
      "HUGO_VERSION": "0.152.2"
    }
  }
}

重新部署后，日志会显示正确的版本号，页面也能正常打开。