如何区分WooCommerce可变产品的自定义图库图与变体图？

要区分get_gallery_image_ids()返回的图片中哪些是手动添加的图库图，哪些是变体图，核心思路是先提取所有变体关联的图片ID，再与原始图库ID数组做对比。

步骤1：获取所有变体的图片ID集合 #

先写一个辅助函数，提取可变产品下所有变体的图片ID：

function get_variation_image_ids( $product_id ) {
    $variation_image_ids = array();
    
    $product = wc_get_product( $product_id );
    
    if ( $product->is_type( 'variable' ) ) {
        $variations = $product->get_available_variations();
        
        foreach ( $variations as $variation ) {
            if ( ! empty( $variation['image_id'] ) ) {
                $variation_image_ids[] = $variation['image_id'];
            }
        }
        
        // 去重，避免同一图片被多个变体引用的重复情况
        $variation_image_ids = array_unique( $variation_image_ids );
    }
    
    return $variation_image_ids;
}

步骤2：过滤并区分两种图片 #

调用上述函数，结合原始图库ID数组做差集，分离出手动添加的图库图片：

$product_id = get_the_ID(); // 替换为目标产品ID
$product = wc_get_product( $product_id );

// 获取所有变体关联的图片ID
$variation_image_ids = get_variation_image_ids( $product_id );

// 获取包含变体图的原始图库ID数组
$all_gallery_ids = $product->get_gallery_image_ids();

// 差集运算：保留不在变体图片数组里的ID，即手动添加的图库图
$custom_gallery_ids = array_diff( $all_gallery_ids, $variation_image_ids );

// 处理手动添加的图库图片
foreach ( $custom_gallery_ids as $attachment_id ) {
    $image_url = wp_get_attachment_image_url( $attachment_id, 'medium' );
    // 此处可添加图片输出或业务逻辑
}

// 处理变体图片
foreach ( $variation_image_ids as $attachment_id ) {
    $image_url = wp_get_attachment_image_url( $attachment_id, 'medium' );
    // 此处可添加图片输出或业务逻辑
}

原理说明 #

WooCommerce的可变产品中，每个变体的图片ID存储在变体的元数据里，通过get_available_variations()可以获取每个变体的完整信息（包含image_id字段）。将这些ID收集并去重后，与get_gallery_image_ids()返回的数组做差集，剩下的就是后台手动添加的「产品图库图片」——因为get_gallery_image_ids()会自动把变体图片合并到结果中。

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