本文详解如何在 woocommerce 购物车中精准实现「针对特定商品分类（如 org-prod）按购买数量阶梯计费」的运费附加逻辑，修正常见误区（如未乘以数量、重复调用 add_fee、错误使用类别判断函数），并提供可直接部署的健壮代码。
本文详解如何在 woocommerce 购物车中精准实现「针对特定商品分类（如 org-prod）按购买数量阶梯计费」的运费附加逻辑，修正常见误区（如未乘以数量、重复调用 add_fee、错误使用类别判断函数），并提供可直接部署的健壮代码。
在 WooCommerce 开发中，为特定商品类别（如 org-prod）按实际购买数量动态加收运费（例如每件 $15），是常见的定制化需求。但许多开发者容易陷入几个典型陷阱：忽略数量因子导致费用固定、在循环内多次调用 add_fee() 覆盖前值、用字符串匹配方式（strstr() + wc_get_product_category_list()）判断分类——既低效又不可靠（易受 HTML 标签或翻译干扰）。
以下是一段经过生产环境验证的优化实现，它严格遵循 WooCommerce 最佳实践：
/**
* 为指定商品分类（支持 slug/name/ID）按数量计算运费附加费
* @param WC_Cart $cart 当前购物车实例
*/
function action_woocommerce_cart_calculate_fees( $cart ) {
// 后台管理页非 AJAX 请求时提前退出（避免影响订单编辑等场景）
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
// ✅ 配置目标分类：支持 slug、名称或 term_id，可多选（如需同时匹配 org-prod 和 org-test，可写成 array('org-prod', 'org-test')）
$target_categories = array( 'org-prod' );
// ✅ 单位费用（每件 $15）
$fee_per_unit = 15;
$total_fee = 0;
// ✅ 遍历购物车商品（推荐使用 get_cart_contents()，语义更清晰）
foreach ( $cart->get_cart_contents() as $cart_item ) {
$product_id = $cart_item['product_id'];
$quantity = $cart_item['quantity'];
// ✅ 使用 has_term() 精准判断分类归属（高效、支持缓存、兼容多语言与自定义结构）
if ( has_term( $target_categories, 'product_cat', $product_id ) ) {
$total_fee += $fee_per_unit * $quantity;
}
}
// ✅ 仅当费用大于 0 时才添加（避免显示 $0 费用，提升用户体验）
if ( $total_fee > 0 ) {
// 第三个参数 true 表示该费用参与税费计算（如需免税，请设为 false）
$cart->add_fee(
__( 'Shipping Fees', 'your-textdomain' ), // 建议使用文本域实现国际化
$total_fee,
true // 是否含税
);
}
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees', 10, 1 );
关键要点说明：
- 数量必须参与计算：$fee_per_unit * $quantity 是核心逻辑，原代码中仅累加固定 $amount，导致无论买 1 件还是 10 件都只收 $15。
- add_fee() 必须在循环外调用一次：在 foreach 内反复调用会覆盖前次结果，最终仅保留最后一次计算值；正确做法是先汇总总费用，再统一添加。
- 优先使用 has_term() 替代字符串解析：wc_get_product_category_list() 返回的是带 HTML 的富文本（如 ORG Prod），strstr() 匹配极易失效；而 has_term() 直接查询数据库关系，准确、高效、无副作用。
- 增强可维护性：通过 $target_categories 数组集中管理规则，后续扩展（如新增 org-test 分类也需收费）只需修改数组即可，无需改动逻辑。
- 国际化准备：__('Shipping Fees', 'your-textdomain') 中的 'your-textdomain' 应替换为你主题或插件的实际文本域，便于后期翻译。
⚠️ 注意事项：
- 此代码需放入子主题的 functions.php 或独立功能插件中；
- 修改后请清空 WooCommerce 缓存（如启用对象缓存需刷新），并在前台购物车页面测试不同组合（如仅含 org-prod 商品、混合其他分类、数量为 0/1/3 等）；
- 若需对 org-test 分类设置不同费率（如 $10/件），可扩展逻辑为分类 → 费率映射数组，而非硬编码单一 $fee_per_unit。
通过以上实现，你将获得一个稳定、可扩展、符合 WooCommerce 架构规范的运费附加方案。
