本文教你通过挂钩 `wp_get_attachment_image_src` 过滤器，精准替换首页 featured image（特色图像）的 `.webp` 后缀为 `.jpg`，解决 `the_content` 过滤器对动态生成缩略图无效的问题。
WordPress 默认使用 WebP 图片可提升加载性能，但部分浏览器或 CDN 可能不兼容 WebP，导致首页缩略图无法显示。你已在文章正文内容中成功用 the_content 过滤器批量替换 标签中的 .webp 为 .jpg，但该方法不适用于程序化获取的缩略图（如 wp_get_attachment_image_src() 返回的 URL），因为这些 URL 并未经过 the_content 渲染流程。
正确做法是直接拦截缩略图 URL 的生成源头——使用 wp_get_attachment_image_src 过滤器。该过滤器在每次调用 wp_get_attachment_image_src()（包括 get_the_post_thumbnail() 内部调用）时触发，接收一个包含 [url, width, height] 的数组，其中 $image[0] 即为原始图片 URL。
✅ 推荐解决方案（添加至主题 functions.php 或子主题中）：
<?php
add_filter('wp_get_attachment_image_src', 'replace_webp_with_jpg_in_thumbnails', 99);
function replace_webp_with_jpg_in_thumbnails($image) {
if (is_array($image) && isset($image[0])) {
$image[0] = str_replace('.webp', '.jpg', $image[0]);
}
return $image;
}
?>⚠️ 注意事项：
- 优先级设为 99 确保在其他插件/主题修改后执行；
- 严格判断 $image 类型与键存在性，避免因空值或非数组导致 PHP 警告；
- 此方案作用于所有缩略图（首页、归档页、后台等），若需限定范围（如仅首页），可在函数内加入条件判断：
if (!is_home() && !is_front_page()) return $image;
- 若服务器实际无对应 .jpg 文件，请同步生成或重命名原图，否则将返回 404；建议配合 webp-to-jpg 插件或构建脚本批量转换。
? 扩展提示：如需更健壮的格式适配（例如根据浏览器 Accept 头智能返回 WebP/JPG），推荐使用 wp_calculate_image_srcset + wp_get_attachment_image_attributes 组合实现响应式图片降级，而非简单字符串替换。
此方法轻量、可靠，直击缩略图 URL 生成链路，完美补全你在首页 featured image 场景下的格式替换需求。
