Spree 如何通过 CSV 字段映射批量导入多规格商品【免费下载链接】spreeOpen Source eCommerce Platform for B2B, Marketplace, and Enterprise. REST API, TypeScript SDK, and production-ready Next.js storefront. Self-host it. Own your stack. No vendor lock-in. Zero platform fees.项目地址: https://gitcode.com/GitHub_Trending/sp/spree当 SKU 数量达到成百上千时在 Spree 后台逐个创建商品不现实。Spree 的 CSV 导入器支持直接上传预先整理好的 CSV 文件批量导入商品并且原生支持单规格和多规格multi-variant商品。核心机制是字段映射你的 CSV 列名不需要与 Spree 内部字段完全一致上传后可以在界面上把每一列手动对应到目标内部字段。本文的操作路径准备一份多规格商品 CSV → 在 Products 页上传并选择分隔符 → 在字段映射步骤中把列对应到内部字段 → 提交后在 processing 界面核对结果。准备多规格商品的 CSV 文件导入前需要确认文件里哪些列是必需的。Spree 文档列出的必填字段模板中以粗体标出只有三个字段说明sku用于标识变体variant的唯一字母数字编码name商品名称slug商品的 URL 路径例如 yourstore.com/products/slug多规格商品的关键在于option系列字段。每个变体最多可以携带三组“选项名 选项值”即 CSV 中的option1_name/option1_value、option2_name/option2_value、option3_name/option3_value六列。同一商品的多个变体通过共享 product 字段、使用不同的sku和不同的 option 值来区分。完整的字段列表和多规格行的排列方式参考 Spree 提供的商品导入文件模板。除必填项和 option 字段外可按需填写以下常见列价格与库存price、compare_at_price、currency、inventory_count、track_inventory、inventory_backorderable尺寸与重量width、height、depth、dimensions_unitin/ft/cm/mm、weight、weight_unitoz/lbs/g/kg状态与时间statusActive、Draft、Archived、available_on、discontinue_on分类与图片category1category3、image1_srcimage3_src图片为链接地址元数据tags、meta_title、meta_description、meta_keywords以及metafield.namespace.key形式的商品 metafield 列税务与配送tax_category、shipping_category两点限制需要留意列名不必照抄模板。Spree 明确说明字段命名可以自定义因为导入时有字段映射步骤但如果列名与内部字段相同或非常接近Spree 会自动匹配命名一致可以省去手动选择。slug是商品在 Spree 中的唯一标识两个商品不能共用同一个 slug。批量更新已有商品时slug 必须与现有记录完全一致否则该行会被当作新商品创建出重复记录。如果店铺配置了多币种导入文件中还可能出现只含定价信息的price-only rows只填 SKU、Slug、Price、Compare At Price、Currency 几列其余留空Spree 导入时会自动识别这些行并只更新对应币种的价格。这一场景的细节见多币种导入/导出。上传文件并选择分隔符在 Spree 管理后台进入Products标签页点击页面右上角的Import打开导入侧边栏在上传区域将 CSV 文件拖入或点击browse files从电脑选择文件。上传成功后界面会提示上传完成注意检查文件格式问题、数据类型不匹配和重复行。上传完成后需要选择文件使用的分隔符这是后续解析的前提选错会导致列全部错位。可选项为,逗号——CSV 最常见|竖线;分号\tTab确认分隔符后点击侧边栏底部的Create进入字段映射步骤。字段映射把 CSV 列对应到 Spree 内部字段这是整个流程的核心步骤。文件上传后界面会列出你的每一列并提示你将其映射到 Spree 的内部字段Spree 会先尝试自动匹配列名与内部字段相同或非常接近时自动对应。对未匹配或匹配错误的列从右侧一列的下拉框中手动选择目标字段。多规格导入时重点核对两组映射是否正确sku、name、slug三个必填列是否都落到了正确的内部字段option1_name/option1_value等 option 列是否映射到对应的选项字段——如果某一组 option 列没映射或映射错位该维度的规格值不会生效。确认所有列映射无误后点击右下角Continue提交导入。监控导入结果提交后会被重定向到 processing 界面在这里可以监控导入进度等待处理完成即可判断结果的方式是逐行错误提示如果文件中有问题行例如缺少必填字段、重复值processing 界面会在受影响的那一行上显示相应的 error message。没有错误提示、处理完成的行即导入成功。因此核对方式就是逐行查看 processing 屏幕是否报错而不是看某个汇总数字。用同一流程批量更新多规格商品同一套上传 → 映射 → 提交流程也用于批量更新已有商品。文档给出的更新路径是从 Products 标签页导出商品目录导出方式见商品导出直接在文件里修改需要变更的数据价格、描述、库存、metafields 等通过导入器重新导入更新后的文件。这条路径有一个硬性条件每个已有商品的 slug 必须原样保留。slug 是导入时用来识别“这是更新”还是“这是新商品”的唯一标识改动它会让 Spree 把该行当新商品处理并创建重复记录。多币种店铺的导出文件包含 price-only rows编辑时不要改动这些行的 SKU 或 slug否则无法匹配到正确的变体记录。相关文档商品导入导入流程的完整说明商品导入文件模板全部可导入字段清单与多规格结构示例商品导出批量更新前导出目录多币种导入/导出price-only rows 的机制与限制商品选项option type 与 option value 的后台管理【免费下载链接】spreeOpen Source eCommerce Platform for B2B, Marketplace, and Enterprise. REST API, TypeScript SDK, and production-ready Next.js storefront. Self-host it. Own your stack. No vendor lock-in. Zero platform fees.项目地址: https://gitcode.com/GitHub_Trending/sp/spree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考