本文介绍如何在wordpress首页等非正文页面中，统一将webp格式的特色图像（featured image）url中的`.webp`后缀替换为`.jpg`，通过挂钩`wp_get_attachment_image_src`过滤器实现全局生效，确保缩略图正确加载。
在WordPress中，若站点启用了WebP图片支持（例如通过插件或服务器配置），默认生成的缩略图可能以.webp结尾。但部分浏览器、CDN或旧版主题对WebP兼容性不佳，导致首页特色图像无法显示。你已成功使用the_content过滤器处理文章正文内的图片，但该过滤器不作用于wp_get_attachment_image_src()等函数返回的原始URL——而首页循环中调用的get_the_post_thumbnail()及其底层函数正是依赖此API获取图片地址。
因此，需改用更底层的过滤器：wp_get_attachment_image_src。它在WordPress返回缩略图URL前触发，接收一个包含[url, width, height]的数组，可安全地对$image[0]（即URL字符串）执行后缀替换：
<?php
add_filter('wp_get_attachment_image_src', 'replace_webp_with_jpg', 99);
function replace_webp_with_jpg($image) {
if (is_array($image) && !empty($image[0])) {
$image[0] = str_replace('.webp', '.jpg', $image[0]);
}
return $image;
}
?>✅ 优势说明：
- 全局生效：不仅影响首页WP_Query循环，也覆盖后台预览、REST API、post_thumbnail_html等所有调用该API的场景；
- 安全可靠：仅修改URL路径，不影响尺寸、alt文本等其他属性；
- 兼容性强：无需修改模板代码，与你现有的
标签逻辑完全解耦。
⚠️ 注意事项：
- 确保目标JPG文件真实存在（如WebP由插件自动生成，需确认其是否同步生成对应JPG版本，否则会返回404）；
- 若需更智能的降级逻辑（如优先尝试JPG，失败再回退WebP），建议结合wp_get_attachment_image_attributes或自定义srcset处理；
- 生产环境请配合缓存清理（对象缓存、页面缓存），避免旧URL被缓存。
总结：the_content适用于HTML内容层替换，而wp_get_attachment_image_src才是控制缩略图源地址的正确入口。一行str_replace + 正确钩子，即可优雅解决首页WebP缩略图兼容问题。
