本文介绍如何通过 `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;
}
?>

✅ 优势说明：

SEO Keyword Density

SEO关键词密度优化与页面审计技能。使用场景：①提供页面路径与关键词进行SEO优化；②提升页面关键词密度；③提升搜索引擎排名；④进行SEO审计（meta标签、OG、hreflang等）。触发词：关键词密度、SEO优化、关键词优化等。

下载

• 全局生效：所有调用 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 文件或自定义插件中，并清除对象缓存（如有），即可立即生效。