本页内容
2026 年 5 月初,我们将内部姊妹网站 Unlimited Charters 重建为 Hugo 静态网站:从 528,853 个源文件生成并部署了 528,854 个页面,并通过 Cloudflare 提供服务。我们保留了现有 URL 路径;对于必须变更的路径,则新增了 35 条 301 重定向。在主要迁移工作完成时,我们的重点 URL 在移动端 PageSpeed(实验室数据)测试中达到了 91-99 分,CLS 为 0。当时仍有少量页面未纳入 Hugo 构建,包括约 75 个 Elementor 快照、约 100 个从未迁移的页面,以及 4 个旧版表单页面。
为什么选择这个网站,以及它为何适合作为测试案例
Unlimited Charters 是与 WordPressEscape 同属一个所有者集团的姊妹网站。它是我们在法律和实际条件允许范围内能够进行实验的最复杂 WordPress 网站:拥有数十万个地点页面、多种页面模板,部分页面使用页面构建器,配备与 CRM 关联的实时报价表单,并积累了多年的插件。
之所以明确说明这些背景,是因为它们会影响你对数据的理解:这是我们自己的网站,由构建这套流程的团队完成迁移,并且我们拥有服务器的完整访问权限。它证明这套流程能够应对大规模网站。它不是客户评价,我们也不会将其包装成客户评价。
初始状态
- 平台:WordPress 搭配自定义主题,部分页面使用 Elementor,配有 Yoast SEO 以及常见的缓存和图片插件,运行在 Cloudflare 后面的 LiteSpeed 服务器上。
- 规模:略超过 50 万个 URL,其中大多数是按模板生成的城市和服务页面,此外还有枢纽页面、车队页面和博客。
- 希望解决的问题:移动端实验室 PageSpeed 通常只有 35 到 50 分;报价组件和图片区域造成布局偏移;大量插件带来维护和安全方面的负担。
我们采取的措施
- 盘点页面模板。我们按照生成页面的 WordPress 模板对所有 URL 进行归类,为每一类模板编写一个 Hugo 布局;对于尚未准备好重建的自定义页面,则采用快照模式。
- 提取内容。每个页面都转换为一个 Markdown 文件,并通过 front matter 固定其原有路径:共生成 528,853 个源文件。
- 分区构建。一次 Hugo 构建 50 万个页面既缓慢又不稳定,因此我们将构建任务分区处理,并先将输出部署到单独目录,完成后再切换上线。(这篇工程说明介绍了其中的陷阱。)
- 保持 URL 一致。路径保持不变。对于 WordPress 中错误或不一致的路径,我们在
.htaccess中添加了 35 条永久重定向,避免出现 404(Google 关于重定向的说明)。 - 清理结构化数据。Search Console 报告结构化数据错误后,我们从 Service 实体中移除了
aggregateRating和review,而不是虚构评价标记(结构化数据)。 - 对整个页面集合进行性能优化:修正 527,815 个页面的图片尺寸;将关键 CSS 从异步文件移入同步文件;取消首屏主图的延迟加载;替换过大的 LCP 图片;将报价组件延迟到用户交互时加载,并预留其所需空间以防止布局偏移。
- 关闭 Cloudflare Email Obfuscation。其解码脚本会在页面加载后重写页面,是持续造成布局偏移的原因之一。
- 清理路径(5 月 7 日)。我们将媒体文件从
/wp-content/uploads/移至/uploads/,并重写了 528,854 个 HTML 文件中的 528,852 个文件的引用,同时为旧图片 URL 添加了 301 规则。
我们测量的数据
以下所有数据均为我们在自己网站上测得的结果。实验室评分来自 PageSpeed Insights / Lighthouse(PageSpeed Insights),每次测试结果可能有所不同。
| 指标 | 之前(WordPress) | 之后(Hugo,2026 年 5 月) |
|---|---|---|
| 已部署页面 | 约 528K 个 URL | 528,854 个正在提供服务 |
| 移动端 PageSpeed(实验室),重点 URL | 通常为 35-50 | 91-99 |
| 累积布局偏移 | 枢纽页面最高达 0.54(报价组件) | 重点 URL 为 0 |
| URL 变更 | 不适用 | 路径保持不变;新增 35 条 301 重定向 |
| 核心网页指标(真实用户数据) | 关键模板未通过 | CrUX 数据更新后,重点 URL 已通过 |
我们已删除本页面早期版本中无法通过自有记录重新核实的数据,包括索引数量、评价分数和单次请求响应时间。如果某个数字没有出现在表格中,就表示我们不对此数字作出声明。
出现的问题
- 两个恢复进程发生竞态,导致约 367,000 个源目录被嵌套到多一层的目录中。由于生产环境提供的是构建后的输出,线上网站未受影响;通过一次脚本化移动即可修复。经验:同一时间只能由一个进程负责内容目录。
- 模板中的图片尺寸被硬编码,导致数十万个页面出现布局偏移,直到我们修正模板并重新生成页面。
- CSS 以异步方式加载,其中包含首屏渲染所需的移动端规则,导致页面后续发生布局变化。
- 实验室数据与真实用户数据混淆:由于 Cloudflare 设置不同,预发布环境的实验室评分与生产环境不一致。现在我们会测量生产环境,并持续观察 28 天的真实用户数据。
- 损坏的内部链接继承自 WordPress 内容,需要在约 250,000 个页面中全面排查。
哪些内容仍保留在 WordPress 中,以及原因
诚实说明范围,比一个漂亮的标题更重要。在主要迁移工作结束时:
- 约有 75 个 Elementor 页面以 WordPress 输出的静态快照形式提供服务,而不是重建为模板。
- 约有 100 个低优先级页面使用通用模板,尚未完成迁移。
- 4 个旧版报价表单页面因需要接入现有工作流,特意继续保留在 WordPress 上。
2026 年 5 月 8 日,在 Hugo 能够生成站点地图、结构化数据、meta 标签和 robots.txt 后,我们移除了 Yoast SEO。
如果你正在考虑迁移,这意味着什么
规模不是难点,稳定一致才是。面对五十万个页面,我们不得不将每项检查都编写成脚本:状态码、标题、规范链接、图片尺寸和内部链接。对于一个包含 40 个页面的网站,同样的检查几分钟内即可完成。具体步骤已记录在 在不损失 SEO 的情况下迁移 和 将 WordPress 迁移到 Hugo 中,而 Google 的 网站迁移指南则是我们遵循的外部参考。
WordPressEscape 由 Stretch LLC 运营。免费扫描使用了我们在本网站上执行过的同一套内容清单步骤,帮助你了解自己的网站迁移需要涉及哪些工作。
来源与延伸阅读
常见问题
Unlimited Charters 是 WordPressEscape 的客户吗?
不是。这是同一所有权集团旗下的内部姊妹网站,用作我们的测试案例。在向其他客户提供服务之前,我们先自行完成了迁移。
迁移了多少个页面?
2026 年 5 月,我们从 528,853 个 Hugo 源文件中部署了 528,854 个页面;正如上文所述,少量页面保留为快照或继续使用 WordPress。
迁移花了多长时间?
主要的构建和切换工作于 2026 年 5 月上旬历时约五天完成,随后又进行了多项清理工作,例如 5 月 7 日调整媒体路径,以及 5 月 8 日移除 Yoast。
有更改任何网址吗?
我们保留了现有路径。对于 35 个不一致的路径,我们设置了永久 301 重定向,将其指向正确页面;旧的 /wp-content/uploads/ 图片网址则重定向至 /uploads/。
该网站运行的是哪个 Hugo 版本?
截至 2026 年 11 月,线上首页的 generator 标签显示该网站使用 Hugo 0.139.4。
执行我们在迁移 UC 前进行的同款审计
免费的 60 秒审计会显示你真实的 PageSpeed 得分、页面数量、SEO 缺口,以及需要替换的具体 WordPress 功能。随后,WordPressEscape 会使用 Hugo 为你重建网站,保留所有 URL,并从第一天起交付源代码 - UC 的重建也采用了完全相同的方式。
免费扫描我的网站

