本文介绍如何通过钩子函数统一隐藏 WooCommerce 中缺货商品（包括简单型与可变型）的价格 HTML，避免仅清空内容却残留空标签的问题，确保前端不渲染 或 。
本文介绍如何通过钩子函数统一隐藏 woocommerce 中缺货商品（包括简单型与可变型）的价格 html，避免仅清空内容却残留空标签的问题，确保前端不渲染 `` 或 `
`。在 WooCommerce 中，当商品库存为 0（is_in_stock() 返回 false）但仍有价格时，默认仍会输出带空内容的 （可变产品）或
（简单产品），这不仅影响页面语义结构，还可能干扰 CSS 样式、SEO 及无障碍访问。虽然你已尝试通过 woocommerce_get_price_html 钩子将 $price 设为空字符串（如 ''），但需注意：WooCommerce 的 get_price_html() 方法本身会对空值做兜底处理——例如在可变产品中，WC_Product_Variable::get_price_html() 内部会调用 wc_price(0) 或拼接默认提示，导致空 仍被包裹输出。因此，关键在于确保钩子返回的是完全空字符串（非 null、非空格、非 ），且优先级足够高以覆盖所有场景。
以下为推荐的健壮实现方案：
add_filter( 'woocommerce_get_price_html', 'remove_price_for_outofstock_products', 10, 2 );
function remove_price_for_outofstock_products( $price, $product ) {
// 对所有产品类型（simple/variable/grouped/etc.）统一判断
if ( ! $product->is_in_stock() ) {
return ''; // 严格返回空字符串，不加空格、不加 HTML 标签
}
return $price;
}
✅ 优势说明：
- ✅ 全局生效：无需区分 simple/variable，woocommerce_get_price_html 是所有产品类型价格渲染的统一入口；
- ✅ 零冗余标签：返回 '' 后，WooCommerce 模板（如 single-product/price.php 和 variable.php 中的价格逻辑）将跳过整个 或
包裹逻辑，真正不输出任何价格容器元素；
- ✅ 免修改核心文件：无需触碰 /wp-content/plugins/woocommerce/includes/class-wc-product-variable.php 或模板文件，符合 WordPress 最佳实践；
- ✅ 兼容性好：适配 WooCommerce 6.0+（含 Block Themes 和 Storefront 主题），且与主流插件（如 YITH Wishlist、CartFlows）无冲突。
⚠️ 注意事项：
- 请将代码添加至当前启用子主题的 functions.php 文件中（切勿修改父主题或 WooCommerce 核心文件）；
- 若使用缓存插件（如 WP Rocket、LiteSpeed Cache），添加后需清除全站缓存；
- 如需对“缺货但可预订”（Backorders enabled）的商品保留价格，请改用 $product->get_stock_quantity() backorders_allowed() 条件；
- 建议配合前端样式增强体验，例如在缺货时显示「缺货中」提示：
add_action( 'woocommerce_single_product_summary', 'display_outofstock_notice_on_single', 11 ); function display_outofstock_notice_on_single() { global $product; if ( ! $product->is_in_stock() ) { echo '<p class="stock outofstock">' . esc_html__( '此商品暂无库存', 'your-textdomain' ) . '</p>'; } }
综上，通过高优先级、强约束的 woocommerce_get_price_html 钩子直接返回空字符串，是实现“彻底移除缺货商品价格 DOM 元素”的最简洁、安全、可维护的方案。
