为脚本添加 defer 是 WordPress 站点上成本最低的提速手段之一。但它也是最容易导致菜单、轮播图或结账字段失效的设置。本文通过一个小示例解释其原因,并展示一种安全的部署方式。
defer 实际改变了什么
经典 <script src> 位于 <head> 中会阻塞解析:浏览器在下载并运行它之后才会构建页面的其余部分。使用 defer 时,浏览器会继续解析,稍后再运行脚本。根据 MDN 文档,延迟执行的脚本:
- 在文档解析完成后、
DOMContentLoaded事件触发前运行 - 按它们在代码中出现的顺序执行
- 仅适用于外部脚本(对内联脚本使用
defer无效)
| 属性 | 阻塞解析? | 何时运行 | 保持顺序? |
|---|---|---|---|
| 无 | 是 | 立即 | 是 |
defer | 否 | 解析后 | 是 |
async | 否 | 下载完成后立即 | 否 |
WordPress 特有的问题:内联脚本
WordPress 主题和插件喜欢在一个文件后立即输出一小段内联脚本。wp_add_inline_script() 正是如此,许多主题也会自行输出:
<script src="/wp-includes/js/jquery/jquery.min.js"></script>
<script>
jQuery(function ($) { $('.hero-slider').slick(); });
</script>
现在对该文件使用 defer:
<script src="/wp-includes/js/jquery/jquery.min.js" defer></script>
<script>
jQuery(function ($) { $('.hero-slider').slick(); }); // 立即运行
</script>
内联块不会被延迟,因此会在 jQuery 尚未加载时就运行:
Uncaught ReferenceError: jQuery is not defined
轮播图为空,除非有人打开控制台,否则无人知晓原因。当某个插件的脚本被延迟而另一个脚本提前调用它时,也会出现同样的 … is not a function 错误。
安全部署步骤
- 延迟所有脚本,除了 jQuery。 让
jquery.min.js和jquery-migrate正常加载;它们是内联代码最常见的依赖项。 - 测试关键页面: 首页、文章页、普通页面、商店页和产品页。不仅要检查首屏,还要测试菜单、标签和轮播图。
- 查看控制台。 错误信息会指明文件名和行号。将该文件加入“不延迟”列表。
- 重复直到没有新错误,然后上线。
- 主题和插件更新后重新测试。 更新可能会引入新的内联代码。
快速发现新错误的一种方法是比较更改前后的控制台。在没有 defer 时已经存在的错误不是你今天的问题;新出现的才是。
自动化比较
手动操作意味着需要频繁刷新页面并打开 DevTools,因此我们在免费的 NodeThemes Cache AI 插件中实现了自动化。它在管理员浏览器的隐藏框架中打开每个测试页面:两次不使用新设置,一次使用新设置。然后进行对比:
- JavaScript 错误(仅新错误,因此站点上已存在的错误不会导致测试失败)
- 无法加载的文件和图片
- 主页面各部分的大小和页面高度
失败的设置不会被应用,每次更改都可以通过一键回滚。Pro 附加功能在测试失败时会更进一步:它将延迟执行的脚本分成两半并重新测试,直到找到必须不延迟的少数文件,同时保留其他所有文件的延迟状态。
它对 Core Web Vitals 有帮助吗?
通常有,主要是 LCP,因为页面可以在脚本运行之前渲染。请在移动设备上测量,进行同类比较,并在随后几天用真实访客数据确认。