如何解决基于Hugo 0.100.0与Cloudflare Pages搭建的博客在PageSpeed中出现的“Uses deprecated APIs”警告？

我来帮你一步步排查和解决这个问题，结合你用Hugo 0.100.0+Cloudflare Pages的场景，PageSpeed的“Uses deprecated APIs”警告通常来自几个常见方向，你可以按下面的步骤逐一排查：

1. 检查主题自带的第三方脚本 #

很多Hugo主题会默认引入旧版的工具库或第三方服务代码，这是最常见的问题来源：

• 先去主题的layouts/partials目录下，查看footer.html、header.html这类加载脚本的文件，看看有没有旧版jQuery（比如v1.x版本，里面可能用到bind()、unbind()这类废弃方法）、旧版Google Analytics（用ga()调用的经典版，而非GA4的gtag()）。
• 解决办法：如果是主题自带的旧脚本，优先升级主题到最新稳定版；如果主题不再维护，就手动替换为最新版的库或服务代码（比如把经典GA换成GA4的嵌入代码）。

2. 排查Cloudflare Pages的优化功能 #

Cloudflare的自动优化工具可能会插入或修改代码，导致触发废弃API警告：

• 临时关闭Cloudflare控制台「Speed」选项下的Auto Minify、Rocket Loader等功能，重新部署博客后再跑PageSpeed检测。如果警告消失，就逐个开启这些功能，定位到具体是哪个工具导致的问题。
• 比如Rocket Loader有时候会使用旧的DOM操作逻辑，你可以在它的设置里排除特定脚本不被处理，或者调整优化策略。

3. 检查自定义模板和Hugo内置生成的代码 #

你自己编写的模板或Hugo内置函数可能生成了含废弃API的代码：

• 查看layouts目录下的自定义模板，有没有内联JS用到document.write()、document.execCommand这类被PageSpeed标记为废弃的方法；或者有没有用Hugo的旧版日期格式化函数，导致生成了需要旧API兼容的代码。
• 解决办法：替换成现代写法，比如用Intl.DateTimeFormat处理日期显示，用appendChild()这类DOM操作代替document.write()。

4. 第三方嵌入内容的问题 #

博客里的评论系统、统计工具等第三方嵌入代码也可能带废弃API：

• 检查Disqus旧版评论框、旧版百度统计这类嵌入代码，换成它们的最新版本；或者考虑替换为更现代的替代方案（比如用Giscus代替Disqus）。

快速定位技巧 #

• 打开Chrome DevTools的「Console」面板，在设置里勾选「Show deprecated APIs」，刷新页面后，控制台会直接显示废弃API的调用位置和具体代码，帮你精准定位源头。
• 查看PageSpeed Insights的「Diagnostics」详情，里面会列出具体的废弃API名称（比如Navigator.userAgent、XMLHttpRequest.open()的旧用法），根据这个名称去搜索你的代码和主题文件，能更快找到问题所在。

内容的提问来源于stack exchange，提问作者AngoraSpace