在 WooCommerce 订单列表页（如 orders.php）中，可根据订单商品数量自动为缩略图容器添加 single-product-img 或 product-img-list 类，提升样式控制灵活性与代码健壮性。
在 woocommerce 订单列表页（如 orders.php）中，可根据订单商品数量自动为缩略图容器添加 `single-product-img` 或 `product-img-list` 类，提升样式控制灵活性与代码健壮性。
要实现在订单页根据商品数量动态应用不同 CSS 类（例如单商品用 .single-product-img，多商品用 .product-img-list），核心在于准确判断当前订单的商品项总数，并安全渲染对应缩略图。推荐使用 WooCommerce 原生方法 $order->get_item_count() 替代 count($order->get_items())，因其已做性能优化并兼容变体、虚拟商品等场景。
以下是经过优化的完整实现代码：
<div class="product-img-col">
<div class="<?php echo $order->get_item_count() > 1 ? 'product-img-list' : 'single-product-img'; ?>">
<?php foreach ( $order->get_items() as $item_id => $item ) {
// 安全获取商品对象：避免因商品被删除或失效导致 PHP 错误
if ( $product = $item->get_product() ) {
// 使用 get_image() 渲染缩略图（支持自定义尺寸、class 等参数）
echo $product->get_image( 'thumbnail', array( 'class' => 'order-item-thumbnail' ) );
}
} ?>
</div>
</div>✅ 关键改进说明：
- ✅ 使用 get_item_count()：比 count(get_items()) 更高效、更语义化，且能正确处理退款项、空项等边界情况；
- ✅ 弃用已废弃方法：$order->get_product_from_item() 已被移除，统一改用 $item->get_product()，无需手动触发 woocommerce_order_item_product 过滤器；
- ✅ 增加空值防护：通过 if ($product = $item->get_product()) 防止因商品已被删除、同步失败或权限异常导致的“Call to a member function get_image() on null”致命错误；
- ✅ 增强可扩展性：get_image() 支持传入尺寸（如 'shop_thumbnail'）和 HTML 属性数组，便于后续精细化控制样式与响应行为。
⚠️ 注意事项：
立即学习“前端免费学习笔记（深入）”；
- 此逻辑适用于 WC_Order 实例上下文（如 orders.php、view-order.php 或自定义订单循环），请确保 $order 变量已正确定义且为有效订单对象；
- 若需对单商品/多商品分别应用完全不同的结构（如单商品显示标题+图片，多商品仅显示图片网格），建议将 if/else 拆分为两个独立区块，而非仅靠 class 切换——但本方案以简洁性与复用性为优先；
- 如项目启用了对象缓存（如 Redis），get_item_count() 会自动利用缓存，无需额外优化。
通过以上方式，您即可在保持代码轻量的同时，实现语义清晰、容错性强、易于维护的动态类名控制策略。
