如何优化 WooCommerce 价格显示以减少 DOM 元素数量

本文提供一种安全、兼容 woocommerce 6+ 的方案，通过重写 `wc_price` 过滤器，彻底移除冗余的 `` 标签，在保留货币语义与可访问性的前提下显著降低 dom 节点数，提升 pagespeed insight 评分。

WooCommerce 默认使用嵌套 包裹货币符号（如 $），导致每个价格显示额外增加 1–2 个 DOM 节点。在商品列表页、购物车或结账页中大量复用时，极易触发 Pagespeed Insight 的 “Excessive DOM elements” 警告（通常建议 DOM 节点总数

真正有效的解法是接管 wc_price() 的完整输出逻辑——该函数是 WooCommerce 所有价格渲染（包括 WC()->cart->get_cart_subtotal()、$product->get_price_html() 等）的统一入口。以下代码直接替换默认价格 html，将货币符号内联至主 中，不新增任何 DOM 节点，同时完全兼容 WC 6.x 及 php 8+：

add_filter('wc_price', 'custom_wc_price', 10, 5);  function custom_wc_price($return, $price, $args, $unformatted_price, $original_price) {     $args = apply_filters(         'wc_price_args',         wp_parse_args(             $args,             array(                 'ex_tax_label' => false,                 'currency'     => '',                 'decimal_separator' => wc_get_price_decimal_separator(),                 'thousand_separator' => wc_get_price_thousand_separator(),                 'decimals'     => wc_get_price_decimals(),                 'price_format' => get_woocommerce_price_format(),             )         )     );      // 安全类型转换，适配 PHP 8 强类型要求     $price = (float) $price;     $negative = $price < 0;     $abs_price = $negative ? $price * -1 : $price;      // 格式化数字部分（不含符号）     $formatted_number = number_format(         $abs_price,         $args['decimals'],         $args['decimal_separator'],         $args['thousand_separator']     );      if (apply_filters('woocommerce_price_trim_zeros', false) && $args['decimals'] > 0) {         $formatted_number = wc_trim_zeros($formatted_number);     }      // 关键优化：将货币符号直接拼入 price_format，避免独立 span     $currency_symbol = get_woocommerce_currency_symbol($args['currency']);     $formatted_price = ($negative ? '-' : '') . sprintf($args['price_format'], $currency_symbol, $formatted_number);      // 统一包裹在单个语义化 span + bdi（保障 RTL 文本正确性）     $return = '' . $formatted_price . '';      // 保留含税标签（如启用）     if ($args['ex_tax_label'] && wc_tax_enabled()) {         $return .= ' ' . WC()->countries->ex_tax_or_vat() . '';     }      return $return; }

✅ 优势说明：

• ✅ 零新增 DOM 节点：货币符号不再包裹在独立 中，而是作为纯文本内联；
• ✅ 完全向后兼容：复用 WC 原生 get_woocommerce_currency_symbol() 和格式化逻辑，支持多货币、RTL、小数精度等全部特性；
• ✅ 性能安全：显式类型转换规避 PHP 8 警告，wp_parse_args 确保参数健壮性；
• ✅ 无障碍友好：保留 标签，确保双向文本正确渲染。

⚠️ 注意事项：

• 请将代码添加至 子主题的 functions.php 中（避免父主题更新覆盖）；
• 若使用缓存插件（如 WP Rocket、LiteSpeed Cache），修改后需清空所有缓存；
• 修改前建议备份当前 functions.php，并在开发环境测试价格显示（含折扣价、变体价格、购物车总计等场景）；
• 此方案不影响 WooCommerce rest api 或后台价格计算，仅改变前端 HTML 输出结构。

通过此优化，典型 WooCommerce 商品列表页（50+ 商品）可减少 100–300 个冗余 DOM 节点，Pagespeed Insight 的 DOM 深度与节点数指标将显著改善，同时保持代码可维护性与 WC 生态兼容性。