WordPress归档页加载原图而非指定缩略图的问题及解决咨询

嘿，我来帮你搞定这个缩略图加载的问题！咱们先拆解原因，再一步步解决：

为什么WordPress会忽略预设缩略图加载原图？ #

可能有这两个核心原因：

• 调用方式未指定尺寸：你只用了the_post_thumbnail()，不传参数的话默认应该加载设置里的「缩略图」（也就是你设的150x150），但如果它加载了原图，大概率是你的主题或某个插件通过post_thumbnail_html过滤器强制替换成了原图URL。
• 缺少匹配的目标尺寸：归档页实际需要的是375x250，这个尺寸不在你预设的三个（150x150/824x824/1024x1024）里，WordPress找不到最贴合的尺寸，就 fallback 到了原图，再通过CSS拉伸到375x250显示。

解决方法分两种情况 #

情况1：想用已预设的缩略图尺寸 #

直接给the_post_thumbnail()传你已经设置好的尺寸名称参数就行，比如：

// 加载150x150的缩略图
the_post_thumbnail('thumbnail');

// 加载824x824的中等尺寸
the_post_thumbnail('medium');

// 加载1024x1024的大尺寸
the_post_thumbnail('large');

情况2：想加载归档页需要的375x250尺寸（更推荐） #

既然页面实际需要这个尺寸，不如直接注册自定义缩略图，避免拉伸或加载过大的图：

1. 注册自定义尺寸：在主题的functions.php里添加这段代码：

function custom_archive_thumbnail() {
    // 最后一个true表示强制裁剪成375x250，false则是按比例缩放
    add_image_size('archive-thumb', 375, 250, true);
}
add_action('after_setup_theme', 'custom_archive_thumbnail');

2. 再生旧图片的缩略图：如果你是之后才加的这个尺寸，之前上传的图片不会自动生成这个尺寸的缩略图，需要用缩略图再生工具处理一下（比如Regenerate Thumbnails这类工具）。
3. 调用自定义尺寸：把归档页的代码改成：

the_post_thumbnail('archive-thumb');

排查强制加载原图的情况 #

如果上面的方法都没用，那得检查主题或插件有没有强制替换缩略图的代码。打开主题的functions.php，看看有没有类似这样的过滤钩子：

add_filter('post_thumbnail_html', 'force_full_image', 10, 5);
function force_full_image($html, $post_id, $thumb_id, $size, $attr) {
    $full_url = wp_get_attachment_image_url($thumb_id, 'full');
    $alt_text = get_post_meta($thumb_id, '_wp_attachment_image_alt', true);
    return '<img src="' . $full_url . '" alt="' . $alt_text . '">';
}

如果有，把这段代码注释掉或者删除，就能恢复正常的缩略图调用了。

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