现象:Cloudflare 构建成功,打开网站是纯文本,CSS 和图片全部 404。

排查:构建日志没有任何错误,说明不是构建问题,是路径问题。

原因:baseURL 写成了 https://xxx.pages.dev,少一个结尾斜杠。Hugo 生成相对路径时会拼成 https://xxx.pages.devassets/css/...,自然找不到。

结论:

baseURL: "https://xxx.pages.dev/"   # 结尾必须有 /

记住这个规律:构建成功但样式全丢 → 先看 baseURL;构建失败报模板错误 → 先看 Hugo 版本。