本文介绍如何通过 `wp_get_attachment_image_src` 过滤器，精准替换首页 featured image（特色图像）的 `.webp` 图片 url 为 `.jpg`，解决 `the_content` 过滤器对缩略图无效的问题。
WordPress 默认使用 WebP 格式可提升加载性能，但在某些 CDN、旧版浏览器或缓存环境下，WebP 图片可能无法正常显示。你已成功用 the_content 过滤器处理文章正文中的 标签，但首页通过 wp_get_attachment_image_src() 获取的缩略图 URL 并未被该过滤器捕获——因为该函数直接返回数组形式的图片信息（含 URL），不经过 HTML 渲染流程，因此 the_content 完全不生效。
正确方案是挂钩 wp_get_attachment_image_src 过滤器，它在返回缩略图 URL 前触发，且接收完整数组 $image = [ $url, $width, $height, $is_intermediate ]。只需修改其中 $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_get_attachment_image_src() 的地方（如 get_the_post_thumbnail_url()、the_post_thumbnail() 内部）均受控；
- 安全可靠：仅替换 URL 字符串，不影响尺寸、缩略图裁剪逻辑或响应式 srcset；
- 无侵入性：无需修改主题模板中
标签的输出逻辑，保持代码解耦。
⚠️ 注意事项：
- 确保目标服务器/CDN 存在对应 .jpg 文件（例如 /uploads/2024/05/photo.webp → /uploads/2024/05/photo.jpg），否则将返回 404；
- 若需更智能的降级（如存在 .jpg 才替换，否则保留 .webp），建议结合 file_exists() 或 wp_remote_head() 检查，但会增加开销，生产环境慎用；
- 如使用了图片优化插件（如 Smush、ShortPixel），请确认其是否已提供“WebP 回退”选项，优先使用插件原生功能以保障兼容性。
最后，将上述代码添加至当前主题的 functions.php 文件或自定义插件中，并清除对象缓存（如有），即可立即生效。
