如何准备 WooCommerce 到 Shopify 商品 CSV
选择迁移路径与商品范围
使用 WooCommerce 原生 CSV 导出并保留备份。这个浏览器本地 Beta 准备新增 Shopify 商品草稿；更完整的迁移可先查看 Shopify 官方迁移指南，以及面向符合条件店铺的早期 Store Migration 应用。
Beta：只支持 WooCommerce 原生英文表头 CSV，最多 100 个普通 simple 商品、15 MiB。variable、variation、grouped、external、virtual 和 downloadable 商品会阻止整份导出。不支持 CSV Import Suite 或翻译后的表头。
变体 Beta：同一原生英文 CSV 内的 simple 商品、具有 1–3 个命名选项的 variable 父商品及明确选项的 variation 记录。最多 100 个商品、每个父商品 100 个变体、10,000 个源记录及 15 MiB。通配值、缺失父商品或不支持的类型会阻止整份输出，不会补造组合。
验证公开操作样例
这些文件原样选取 2026 年 10 月 7 日获取的 WooCommerce 官方样本记录。它们是演示商品，用来理解流程，不用于迁移自己的店铺。
默认模式：12 个普通 simple 商品
保持明确变体模式关闭。simple 样例包含 12 个普通商品，生成 12 个草稿。Hoodie with Logo 行使用 woo-46、SKU woo-hoodie-with-logo 和 Regular price 45。不支持的类型仅从这个已说明的样例中排除；上传文件中任一无效或不支持行都会阻断整份输出。
下载官方简单商品样例主动开启：一个父商品与四个变体
开启明确 variable / variation 模式。Hoodie 样例有 5 条源记录：一个父商品和四个实际变体。输出一个 woo-45 草稿，含下表四个 Color / Logo 组合，每个价格为 45。父商品不增加一个变体，也不补造缺失的 Red / Yes 与 Green / Yes 组合。
下载官方明确变体样例| SKU | Color | Logo | Regular price → Price |
|---|---|---|---|
woo-hoodie-red | Red | No | 45 |
woo-hoodie-green | Green | No | 45 |
woo-hoodie-blue | Blue | No | 45 |
woo-hoodie-blue-logo | Blue | Yes | 45 |
阻断样例：变体通配值
单独的 V-Neck 样例有 4 条记录，子变体 Size 值为空。明确变体模式会阻断全部 4 行，不生成输出。应提供真实受支持的变体数据，不通过删行或补造组合绕过问题。
下载官方通配值失败样例转换、复核并检查草稿
- 下载一个样例并在转换工具中选择它。自己的任务使用原生英文表头、UTF-8 CSV；需要变体时主动开启模式，切换会清除旧结果。
- 运行本地预览，核对目标 handle、子 SKU、选项组合、Regular price、图片 URL 与全部省略字段。明确变体样例应有 1 商品 / 4 实际变体；simple 样例应有 12 条源记录。
- 复核新增商品、同币种与 draft 条件，以及显示时的额外变体确认。零价另行确认，再生成并下载 Shopify 草稿 CSV 与转换报告。
- 点击“用 Validator 检查草稿”，在同一浏览器会话中交接生成文件，无需再次上传。按新增商品场景复核结果；两个公开成功样例的 blocker、warning 与 review 均为 0。
复核映射与省略信息
Name 写入 Title、ID 生成新的 woo-ID handle、Regular price 写入基础 Price；不换算币种，也不保留 WooCommerce 原 URL。变体输出使用父商品标题/描述、子 SKU/价格和准确选项值。库存、重量、税费、Sale price、Categories、Tags、Short description、插件字段与默认选择不迁移；变体模式还省略父 SKU/价格与子 Name/Description。报告统计非空未迁移单元格，包含部分映射字段。发布前需要复核 Shopify 默认值。
Images 必须为逗号分隔的绝对 HTTP(S) URL，不含凭据或转义逗号。额外图片写入续行。工具不请求图片 URL，仍需核对可用性及 Shopify 是否接受。
Description 原样保留，包括 HTML；Short description 不迁移。预览按文本展示，请在目标商店复核 HTML 及 WooCommerce 链接。商品单元格原样保留；若担心表格软件执行公式，请使用文本方式查看 CSV。
目标店铺中的复核事项
有测试商店后，先检查目标 handle 和 SKU 冲突，以覆盖关闭的方式少量试导入，再核对 draft、渠道、变体、图片关联、描述、币种、库存、税费与配送。没有后台时可以完成转换、下载和本地验证；店铺接受情况仍待验收。Validator 无问题不能证明图片可抓取或 Shopify 导入成功。
检查 CSV