本文详解如何在 WooCommerce 中使用标准按钮（而非链接）为多个商品指定独立数量并一次性加入购物车，重点纠正 data-quantity 的正确用法、多商品场景的限制及推荐实现方案。

本文详解如何在 woocommerce 中使用标准按钮（而非链接）为多个商品指定独立数量并一次性加入购物车，重点纠正 `data-quantity` 的正确用法、多商品场景的限制及推荐实现方案。

在 WooCommerce 中，许多开发者尝试通过 元素的 value 属性直接拼接 product_id,quantity（如 value="332,333&quantity=2,1"）来实现多商品批量加购，但该方式无法生效——WooCommerce 的默认加购逻辑仅将 value 视为单一商品 ID，&quantity= 部分会被忽略，最终所有商品均以数量 1 加入购物车。

✅ 正确做法是：为单个商品按钮添加 data-quantity 属性。该属性被 WooCommerce 官方 JavaScript 脚本识别，并在提交时自动注入对应数量：

<!-- ✅ 正确：为单商品按钮设置 data-quantity -->
<button type="submit" name="add-to-cart" value="332" class="single_add_to_cart_button button alt" data-quantity="3">
  Add 3 × Product #332 to Cart
</button>

⚠️ 重要限制：data-quantity 仅支持为单个商品指定数量。WooCommerce 核心不原生支持一个按钮同时添加多个商品且各自携带不同数量（例如 332→2件, 335→1件, 338→4件）。若强行在 value 中传入逗号分隔的 ID 列表（如 value="332,335,338"），系统会将其当作无效 ID 或仅处理第一个 ID，其余被丢弃。

? 替代方案（适用于多商品多数量场景）：

• 方案一：使用表单 + 自定义处理钩子
  构建包含多个隐藏字段的
  ，每个商品对应一组 name="cart_item[{$product_id}][quantity]" 和 name="cart_item[{$product_id}][id]"，再通过 woocommerce_add_to_cart_redirect 或 woocommerce_add_to_cart 钩子解析并批量添加。
• 方案二：AJAX 批量加购（推荐）
  前端收集商品 ID 与数量映射（如 {332: 2, 335: 1, 338: 4}），调用自定义 AJAX 端点；后端使用 WC()->cart->add_to_cart() 循环添加，并返回结果。

? 注意事项：

• 确保主题或插件未禁用或覆盖 WooCommerce 的 add-to-cart.js —— data-quantity 依赖此脚本生效；
• 按钮必须保留 class="single_add_to_cart_button" 才能被 WooCommerce JS 自动绑定事件；
• 数量值需为正整数，负数或非数字将导致添加失败；
• 如需支持变量产品或自定义选项，还需同步传递 variation_id 和 variation 参数。

总结：data-quantity 是实现「单商品多数量」按钮的标准、安全且可维护的方式；而「多商品多数量」需脱离默认按钮机制，采用表单提交或 AJAX 方案，以确保数据准确性和用户体验一致性。