嵌套 lineitem 是 shopware 6 官方支持的高级购物车功能，用于逻辑分组子项（如定制选项、配件、变体），提升订单结构化表达能力，虽无后台原生 ui 支持，但被 custom products 等官方扩展深度使用。
嵌套 lineitem 是 shopware 6 官方支持的高级购物车功能，用于逻辑分组子项（如定制选项、配件、变体），提升订单结构化表达能力，虽无后台原生 ui 支持，但被 custom products 等官方扩展深度使用。
在 Shopware 6 的购物车模型中，LineItem 不仅可表示商品本身，还可通过 setChildren() 方法关联一个 LineItemCollection，从而构建树状嵌套结构。这种设计并非实验性特性，而是经过完整单元测试验证、持续维护的官方支持功能——如 Shopware 官方测试用例所示：
$cart = new Cart('test', 'test');
$nestedItem = (new LineItem('custom-shirt', 'product'))
->setChildren(new LineItemCollection([
(new LineItem('embroidery', 'customization'))->setQuantity(1)->setGood(false),
(new LineItem('premium-packaging', 'addon'))->setQuantity(1)->setGood(false),
]));
$cart->add($nestedItem);
$cart->add((new LineItem('standalone-hat', 'product'))->setGood(true));
该结构在 Cart::getLineItems()->getFlat() 中返回全部扁平化条目（含子项），共 4 条；而 getLineItems() 仅返回顶层 2 条（1 个嵌套主项 + 1 个普通项），便于分别处理主商品与附属服务。
典型使用场景包括：
- ✅ 可配置商品（Custom Products）：将主商品（如 T 恤）作为父项，刺绣、印花、加急配送等作为子项，统一归属、共享库存逻辑，但独立计价与标识；
- ✅ 捆绑销售（Bundles）：以组合商品为父项，内含多个 SKU 子项，支持整体折扣或单独退换；
- ✅ 服务类附加项：如“安装服务”作为子项挂载于大家电商品下，保持业务语义清晰。
⚠️ 注意事项：
- 后台管理界面（Admin API / Order creation UI）当前不提供嵌套 LineItem 的可视化创建入口，需通过插件在 storefront 或 API 层主动构造；
- 子项默认
setGood(false)（非商品型），避免被错误计入库存扣减或 ERP 同步主商品流； - 订单导出、发票生成、退款逻辑需插件自行适配嵌套结构，Shopware 默认仅遍历顶层
LineItem； - 使用前建议调用
$lineItem->hasChildren()判断，并通过$lineItem->getChildren()安全访问子集合。
总之，嵌套 LineItem 是 Shopware 6 构建复杂电商逻辑的关键抽象能力——它不追求开箱即用的 UI，而是为插件开发者提供语义丰富、结构可控的底层模型支撑。只要遵循 good 标识约定、正确处理扁平/层级双视图，即可稳健支撑高阶业务需求。
