本文详解如何在 WooCommerce 中精准实现“订单实付金额满 60 元即免运费”，避开 subtotal 或 total 的陷阱，改用 cart_contents_total 获取纯商品金额（不含运费、税费、优惠券折扣），并通过动态遍历所有启用的配送方式统一设为零成本，并正确处理税费与标签提示。
本文详解如何在 woocommerce 中精准实现“订单实付金额满 60 元即免运费”，避开 `subtotal` 或 `total` 的陷阱，改用 `cart_contents_total` 获取纯商品金额（不含运费、税费、优惠券折扣），并通过动态遍历所有启用的配送方式统一设为零成本，并正确处理税费与标签提示。
在 WooCommerce 中实现条件性免运费时，一个常见误区是依赖 WC()->cart->subtotal（仅含商品原价总和，未扣优惠券）或 WC()->cart->total（含 HTML 标签且可能包含运费/税额，不可直接用于数值判断）。真正反映用户“为商品实际支付了多少”的字段是 WC()->cart->cart_contents_total ——它返回一个浮点数，精确表示购物车中所有商品在应用优惠券、折扣后的净金额（不含运费、税费），是判断免运费逻辑的理想依据。
以下代码实现了健壮、可扩展的免运费方案：
function filter_woocommerce_package_rates( $rates, $package ) {
// ✅ 正确获取折扣后商品总金额（不含运费、税费）
$cart_total = WC()->cart->cart_contents_total;
// 满 59.99 元（即 ≥60 元）触发免运费
if ( $cart_total >= 59.99 ) {
foreach ( $rates as $rate_key => $rate ) {
// ⚠️ 若已启用“免费配送”方法，直接移除——避免与零成本配送并存造成混淆
if ( 'free_shipping' === $rate->method_id ) {
unset( $rates[ $rate_key ] );
} else {
// ✅ 统一设置运费为 0
$rates[ $rate_key ]->cost = 0;
// ✅ 清空对应税费（若启用了税率计算）
$taxes = array();
foreach ( $rate->taxes as $tax_key => $tax_amount ) {
$taxes[ $tax_key ] = 0;
}
$rates[ $rate_key ]->taxes = $taxes;
// ✅ 可选：在配送名称后添加清晰视觉提示（如 “标准配送 (free)”）
$rates[ $rate_key ]->label .= ' ' . __( '(free)', 'woocommerce' );
}
}
}
return $rates;
}
add_filter( 'woocommerce_package_rates', 'filter_woocommerce_package_rates', 10, 2 );
关键说明与注意事项：
- 缓存刷新：WooCommerce 会对运费结果进行缓存。修改代码后，务必清空购物车（或访问 /cart/ 页面并点击“更新购物车”），否则旧缓存可能导致规则不生效。
- cart_contents_total vs total：$cart->total 返回带格式化的字符串（如 "$72.50"），无法直接比较；而 $cart->cart_contents_total 是纯数字（如 72.5），安全可靠。
- 兼容性：该方案自动适配任意数量的配送方式（Flat Rate、Local Pickup、Custom Shipping 等），无需硬编码 flat_rate:1、flat_rate:2，大幅提升可维护性。
- 税费处理：若站点启用了基于运费的税种（如美国部分州），必须显式将 $rate->taxes 数组重置为全零，否则运费虽为 0，税费仍可能保留。
- 免费配送方法冲突：当用户满足条件时，若同时启用了“Free Shipping”配送规则，建议 unset() 掉它，防止前台显示重复选项或逻辑冲突。
将以上代码添加至主题的 functions.php 文件（推荐使用子主题）或通过 Code Snippets 插件部署，即可实现精准、专业、无副作用的满额免运费功能。
