Hugo 博客多平台部署与 baseURL 配置
本站同一份源码部署在多个平台（GitHub Pages / Vercel / Netlify / Cloudflare Pages …）， 但主域名只有一个。本文档说明配置方式。 一、本站采用的方案：主域名统一 hugo.yaml 里 baseURL 填的是主域名： baseURL: "https://blog.646474.xyz/" 所有平台都用这一个值，构建命令不需要任何额外参数。这样做的效果： 内容 实际行为 CSS / JS 资源 用相对路径（/assets/...）→ 每个平台都能正常加载 文章图片 根相对路径（/images/...）→ 同上 canonical 统一指向 https://blog.646474.xyz/... sitemap.xml / rss.xml 统一指向主域名 分享卡片（OG / Twitter） 统一指向主域名 SEO 效果 权重集中在主域名，不存在重复内容问题 其他平台的角色 镜像 / 备用入口（访问正常，但不与主站争夺收录） 这是最省心的多平台方案：配一次，处处可用。 二、各平台配置表 平台 构建命令 输出目录 需要的环境变量 GitHub Pages hugo --gc --minify public 无（本仓库 Actions 已配好，只需 DEPLOY_TOKEN Secret） Vercel hugo --gc --minify public HUGO_VERSION = 0.167.0 Netlify hugo --gc --minify public HUGO_VERSION = 0.167.0 Cloudflare Pages hugo --gc --minify public HUGO_VERSION = 0.167.0 其他平台 hugo --gc --minify public 视平台而定 关键：HUGO_VERSION 必须填 0.167.0，且必须是 extended 版本（PaperMod 用 SCSS，标准版会构建失败）。Cloudflare Pages 默认装的即是 extended；Vercel / Netlify 需要确认。 ...