本文提供一种安全、兼容 woocommerce 6+ 的方案，通过重写 `wc_price` 过滤器，彻底移除冗余的 `` 标签，在保留货币语义与可访问性的前提下显著降低 dom 节点数，提升 pagespeed insight 评分。
WooCommerce 默认使用嵌套 zuojiankuohaophpcnspan> 包裹货币符号（如 <span class="woocommerce-Price-currencySymbol">$</span>），导致每个价格显示额外增加 1–2 个 DOM 节点。在商品列表页、购物车或结账页中大量复用时，极易触发 Pagespeed Insight 的 “Excessive DOM elements” 警告（通常建议 DOM 节点总数 < 1500）。此前尝试的 woocommerce_currency_symbol 或 formatted_woocommerce_price 钩子仅修改内容，无法控制 HTML 结构，因此无效。
真正有效的解法是接管 wc_price() 的完整输出逻辑——该函数是 WooCommerce 所有价格渲染（包括 WC()->cart->get_cart_subtotal()、$product->get_price_html() 等）的统一入口。以下代码直接替换默认价格 HTML，将货币符号内联至主 <span> 中，不新增任何 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 = '<span class="woocommerce-Price-amount amount"><bdi>' . $formatted_price . '</bdi></span>';
// 保留含税标签（如启用）
if ($args['ex_tax_label'] && wc_tax_enabled()) {
$return .= ' <small class="woocommerce-Price-taxLabel tax_label">' . WC()->countries->ex_tax_or_vat() . '</small>';
}
return $return;
}✅ 优势说明：
- ✅ 零新增 DOM 节点：货币符号不再包裹在独立 <span class="woocommerce-Price-currencySymbol"> 中，而是作为纯文本内联；
- ✅ 完全向后兼容：复用 WC 原生 get_woocommerce_currency_symbol() 和格式化逻辑，支持多货币、RTL、小数精度等全部特性；
- ✅ 性能安全：显式类型转换规避 PHP 8 警告，wp_parse_args 确保参数健壮性；
- ✅ 无障碍友好：保留 <bdi> 标签，确保双向文本正确渲染。
⚠️ 注意事项：
- 请将代码添加至 子主题的 functions.php 中（避免父主题更新覆盖）；
- 若使用缓存插件（如 WP Rocket、LiteSpeed Cache），修改后需清空所有缓存；
- 修改前建议备份当前 functions.php，并在开发环境测试价格显示（含折扣价、变体价格、购物车总计等场景）；
- 此方案不影响 WooCommerce REST API 或后台价格计算，仅改变前端 HTML 输出结构。
通过此优化，典型 WooCommerce 商品列表页（50+ 商品）可减少 100–300 个冗余 DOM 节点，Pagespeed Insight 的 DOM 深度与节点数指标将显著改善，同时保持代码可维护性与 WC 生态兼容性。
