我们已正式完成 netguide.jp 从 WordPress 到 Hugo（现代静态站点生成器 (SSG)）的过渡。
运营像 WordPress 这样的动态 CMS 已经越来越受到页面加载延迟、安全更新和托管成本的瓶颈。迁移到静态工作流程解决了所有这些问题。在此案例研究中，我们分享了我们的动机、迁移策略以及迁移后的性能提升。
1.我们离开 WordPress 的三个原因
虽然 WordPress 仍然是一个高度通用的 CMS，但随着我们内容的增长，其动态的数据库驱动架构提出了严峻的挑战：
- 页面速度限制（核心网络生命） 累积的数据库查询和繁重的插件严重降低了移动性能，对我们的核心网络生命（特别是 LCP 和 INP）产生负面影响，并拖累搜索排名。
- 维护开销和安全风险 WordPress 核心、主题和插件始终是漏洞的目标。连续的测试和更新周期需要太多的手动时间来防止黑客攻击。
- 托管开销 快速大规模运行动态 PHP 页面需要高级 VPS 托管，从而导致每月的运营费用很高。
2. 迁移设计：Hugo + Stack 主题
我们选择 Hugo，最快的 Go 驱动的静态站点生成器，搭配高度抛光的 Stack 主题 (hugo-theme-stack)。
🌐 多语言建筑（日文/英文）
我们构建了系统，在 /ja/ 下提供日语内容，在 /en/ 下提供英语内容。除了适当的 HTML 替代标签之外，我们还生成了嵌入 xhtml:link （hreflang 注释）的 Google 兼容 XML 站点地图，以保持多语言 SEO 完美一致。
🖼️ 通过 AVIF 进行图像优化
为了最大限度地提高交付速度，我们创建了一个资产管道，可自动将原始 PNG 和 JPEG 缩略图转换为高度压缩的下一代 AVIF 图像。
🔗 完整的重定向策略
当我们将 URL 格式从嵌套日期路径更改为干净的 slugs（例如 /ja/software/...）时，我们在 _redirects 文件中配置 104 重定向，确保传入的搜索引擎链接汁或用户书签不会中断。
3.逐步过渡
我们分四个主要阶段执行迁移：
- 导出 WordPress 数据 我们使用导出插件将所有原始 HTML 内容、元数据、发布日期、slugs 和特色图像关联下载为结构化 XML 格式。
- 转换为 Markdown
使用自定义解析脚本，我们将 XML 数据库记录转换为配备 front-matter 的 Markdown 文件（
.ja.md和.en.md）。 - 应用主题和覆盖
我们在目录内构建了
hugo-theme-stack，设置本地化搜索、标签云和目录。 - 优化图像资源 我们运行图像自动化脚本来重新生成优化的 AVIF 资源，以及独特的浅色和深色模式缩略图设计。
4. 📈 迁移后结果
通过在 Cloudflare Pages 上托管新生成的静态 HTML 输出，我们立即观察到了改进：
- PageSpeed Insights 已达到最大 移动性能得分达到100/100。我们的最大内容绘制 (LCP) 缩短至 0.6 秒以下，使过渡感觉是瞬时的。
- 零托管成本 利用 Cloudflare 的全球边缘网络意味着我们可以在免费套餐上满足数百万个请求，完全消除我们每月的 VPS 托管费用。
- 绝对安全 如果没有数据库或动态 PHP 层，SQL 注入或暴力管理攻击等常见漏洞在结构上是不可能的。
💬最终想法
虽然 SSG 的初始设置需要付出努力，但速度、成本、安全性和 SEO 稳定性方面的长期优势使得从 WordPress 切换到 Hugo 成为您可以为 Web 平台做出的最佳投资之一。