Wowchemy站点构建失败求助：未固定Go/Hugo版本致构建异常

问题核心 #

站点构建失败的原因是旧版Wowchemy（v5.7.1，2023年5月）与新版Hugo（0.126.1）不兼容。Hugo在v0.120.0版本后对模板API做了破坏性变更，包括.File对象的结构调整，导致旧版Wowchemy模板中调用的.File.UniqueID无法被识别。

解决方案 #

1. 固定Hugo兼容版本 #

修改GitHub Actions配置，将Hugo版本固定为与Wowchemy v5.7.1兼容的0.119.0（这是Hugo v0.120.0之前的最后一个稳定版，完全适配旧版Wowchemy）：

name: CI
on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    concurrency:
      group: ${{ github.workflow }}-${{ github.ref }}
    steps:
    - uses: actions/checkout@v3
      with:
        path: 'repo'
        fetch-depth: 0
    - name: Setup Hugo
      uses: peaceiris/actions-hugo@v2
      with:
        hugo-version: '0.119.0'  # 替换为固定兼容版本
        extended: true
    - name: Build
      run: (cd repo; hugo --gc --minify -b "https://cs.rit.edu/~dataunitylab/")

2. 修复Google Analytics弃用警告（可选但推荐） #

Hugo v0.120.0弃用了旧的googleAnalytics配置项，可同步修改站点配置文件（如config/_default/config.toml）：

• 移除旧配置：

  googleAnalytics = "UA-XXXXXXXXX-X"
  

• 添加新配置：

  [services.googleAnalytics]
    id = "UA-XXXXXXXXX-X"
  

验证操作 #

提交修改后的GitHub Actions配置文件，触发自动构建，即可恢复站点的正常编译部署。

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