如何彻底禁用WooCommerce产品图库的缩略图生成与显示？

嘿，针对你想要彻底禁用WooCommerce产品图库缩略图生成和显示的需求，我整理了几个更优雅的方案，不用粗暴删除模板文件，还能最大化优化页面加载：

方案1：从源头禁用缩略图生成+输出（最推荐） #

这个方案分两步，既阻止WooCommerce生成多余的缩略图（节省服务器空间），又彻底移除页面上的缩略图输出（减少页面加载资源），比CSS隐藏更高效。

• 阻止缩略图尺寸生成：在主题的functions.php中添加以下代码，取消WooCommerce为产品图库注册的缩略图尺寸，并禁止生成对应图片：

// 取消WooCommerce产品图库缩略图尺寸的注册
add_filter( 'woocommerce_get_image_size_gallery_thumbnail', '__return_false' );

// 禁止为产品图库附件生成缩略图
add_filter( 'wp_generate_attachment_metadata', 'disable_wc_gallery_thumb_generation', 10, 2 );
function disable_wc_gallery_thumb_generation( $metadata, $attachment_id ) {
    $parent_post = get_post( wp_get_post_parent_id( $attachment_id ) );
    // 仅针对产品的图库图片生效
    if ( $parent_post && $parent_post->post_type === 'product' ) {
        // 移除图库缩略图的生成记录
        unset( $metadata['sizes']['gallery_thumbnail'] );
        // 如果还想禁用其他产品相关缩略图，比如'woocommerce_thumbnail'，也可以在这里unset
    }
    return $metadata;
}

• 移除默认缩略图输出：通过钩子移除WooCommerce默认的产品缩略图输出逻辑，确保页面不会加载任何缩略图相关HTML：

// 移除产品页面的缩略图输出钩子
remove_action( 'woocommerce_product_thumbnails', 'woocommerce_show_product_thumbnails', 20 );

方案2：优雅修改模板文件（不删除内容） #

如果你想保留模板文件但不输出缩略图，可以在product-thumbnails.php开头添加返回逻辑，保留原有的版本兼容代码，避免后续WC更新冲突：

// Note: `wc_get_gallery_image_html` was added in WC 3.3.2 and did not exist prior. This check protects against theme overrides being used on older versions of WC.
if ( ! function_exists( 'wc_get_gallery_image_html' ) ) {
    return;
}

// 直接返回，不输出任何缩略图内容
return;

// 原有的模板代码可以保留（但上面的return会让它不执行），或者注释掉也可以

方案3：配合滑块禁用的优化方案 #

你之前尝试的remove_theme_support( 'wc-product-gallery-slider' );只是禁用滑块功能，不会阻止缩略图生成和显示。可以把它和钩子代码结合，实现完全禁用：

// 禁用产品图库滑块支持
remove_theme_support( 'wc-product-gallery-slider' );
// 移除缩略图输出
remove_action( 'woocommerce_product_thumbnails', 'woocommerce_show_product_thumbnails', 20 );
// 阻止缩略图生成
add_filter( 'woocommerce_get_image_size_gallery_thumbnail', '__return_false' );

小提示 #

• 如果你已经生成了旧的产品图库缩略图，可以用插件（比如Media Cleaner）清理掉这些多余的图片，进一步优化服务器空间。
• 方案1是最推荐的，因为它从生成和输出两个层面彻底解决问题，对页面加载性能的提升最明显。

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