Shopify 批量导入导出:CSV 产品导入、模板与报错修复
本指南介绍批量导入和导出 Shopify 数据的常用方法:Shopify 自带的 CSV 导入、可直接复制的列模板、CSV 导入失败时的修复办法,以及如何迁移产品、图片、元字段、订单和客户。
批量修改是更新商店最快的方式,也是最快把商店弄乱的方式,因为一列出错就可能影响成千上万条记录。所以这里的每种方法都从备份开始,并留有回退的办法。
BluePeacock 团队撰写阅读约 8 分钟
- 1您的 CSV 或 Excel 文件
- 2测试运行:暂不做任何改动
- 3您的 Shopify 商店
- 一键撤销
要点速览
Shopify 后台可从不超过 15 MB 的 UTF-8 CSV 文件导入产品和客户。本指南提供所需的列、一个模板、常见错误的解决方法,以及安全运行大批量导入和导出的方法。
- 从您自己商店的导出文件开始:它包含所有列,且顺序正确。
- 另存为 CSV UTF-8,表头与 Shopify 的写法完全一致,图片使用公开的 https 链接。
- 开启覆盖后,单元格留空时 Shopify 会清除该值。所以不想改的列,请直接从文件中删去。
- Shopify 帮助中心(2026年11月6日查阅)既没有介绍订单导入,也没有介绍撤销功能。
- 每次大批量导入前都先测试,并保留一份导出的备份,这样出错时可以恢复。
1批量导入和导出 Shopify 数据的两种方法
Shopify 后台自带免费的 CSV 工具。根据 Shopify 帮助中心(2026年11月6日查阅),它可以从 CSV 文件导入产品和客户,并导出产品、客户和订单。它适合您仔细制作的小型产品文件。
| Shopify 后台 CSV | BluePeacock | |
|---|---|---|
| 可读取的文件 | 仅限 UTF-8 编码的 CSV | CSV、Excel 和 Google Sheets 链接,支持 UTF-8 或旧版 Windows 西文编码 |
| 更新时的空白单元格 | 开启覆盖时会清除已有值 | 保留已有值不变 |
| 查找已有产品的依据 | URL handle(网址标识) | 产品 ID、handle 或 SKU |
| 导入开始后 | 无法取消;没有导入历史 | 可取消运行中的任务;每个任务及其文件都会保留 |
| 撤销 | 未说明 | 根据保存的旧值一键撤销 |
| 定时任务 | 未说明 | 按计划运行导入和导出 |
2如何用 CSV 文件把产品导入 Shopify
Shopify 自带的产品导入步骤如下:
- 1下载 Shopify 的示例产品 CSV,或导出几个产品,以获得您商店使用的准确列。
- 2每个产品填一行,每个多属性或每张额外图片再各加一行。
- 3把文件保存为 UTF-8 编码的 CSV。
- 4在 Shopify 后台进入“产品”,选择“导入”。
- 5选择文件。只有在确实要替换现有值时,才勾选 “Overwrite products with matching handles”(覆盖 handle 相同的产品)。
- 6上传文件并开始导入。
3Shopify CSV 导入限制:先了解这些
根据 Shopify 帮助中心(2026年11月6日查阅),规则如下:
4Shopify 产品 CSV 模板:需要哪些列
Shopify 当前的示例文件以 Title 和 URL handle 开头。URL handle 把每一行与一个产品对应,所以 handle 相同的所有行都属于同一个产品。表头必须与 Shopify 的拼写完全一致。
大多数产品导入只需要这些列:
| 列 | 填写内容 |
|---|---|
| Title 和 URL handle | 产品名称和它的网址。 |
| Description、Vendor、Type 和 Tags | |
| Status | 例如 Active 或 Draft。 |
| Option1 name 和 Option1 value | 例如 Size 和 Small。最多三个选项。 |
| SKU、Price 和 Compare-at price | |
| Inventory quantity | 仅适用于只有一个地点的商店。 |
| Product image URL 和 Image position | |
| SEO title 和 SEO description |
| Title | URL handle | Vendor | Status | SKU | Price | Product image URL | Image position |
|---|---|---|---|---|---|---|---|
| Linen shirt | linen-shirt | Harbor Co | Active | LS-01 | 39.00 | https://example.com/linen-front.jpg | 1 |
| linen-shirt | https://example.com/linen-back.jpg | 2 | |||||
| Wool scarf | wool-scarf | Harbor Co | Draft | WS-01 | 25.00 | https://example.com/scarf.jpg | 1 |
5如何为一个产品导入多张图片
根据 Shopify 帮助中心(2026年11月6日查阅),一个产品最多可以有 250 张图片。每张图片需要单独一行:
- 1第一行填写产品信息和第一张图片的 URL。
- 2每张额外图片新增一行,只填写 URL handle 和 Product image URL。
- 3把 Image position 设为 1、2、3,图片就会按这个顺序显示。
6如何用 CSV 导入元字段
Shopify 产品 CSV 以额外列的形式接收产品元字段。表头写明元字段,例如 “Fabric (product.metafields.custom.fabric)”。根据 Shopify 帮助中心(2026年11月6日查阅),不支持多属性元字段,客户 CSV 也只接受少数几种简单的元字段类型。
7Shopify CSV 导入失败?常见报错与修复方法
以下报错和修复方法来自 Shopify 帮助中心(2026年11月6日查阅),另外加上一个引发很多问题的 Excel 习惯:
| 错误或现象 | 解决方法 |
|---|---|
| “Illegal quoting” 或 “Missing or stray quote”(引号错误) | Excel 添加了弯引号,或文件不是 UTF-8。请另存为 CSV UTF-8,并把弯引号换成直引号。 |
| 重音字母变成奇怪的符号 | 文件不是 UTF-8。请重新保存为 UTF-8。 |
| “Invalid CSV header”(CSV 表头无效)或弹出 “Choose column headings” 窗口 | 某个表头拼写错误或末尾有空格。表头区分大小写,请从 Shopify 示例文件中复制。 |
| “An error occurred while trying to download the image”(下载图片时出错) | 图片 URL 不公开,或不是以 http:// 或 https:// 开头。 |
| “Ignored line … because it did not contain product data”(该行不含产品数据,已忽略) | 某一行有 handle 但没有 title。 |
| “Options are not unique”(选项不唯一) | 两个多属性的选项值相同。 |
| “Price can't be blank” 或 “Inventory quantity is not a number”(价格为空或库存数量不是数字) | 在单元格中填入纯数字。 |
| 导入后图片消失 | 文件在 Excel 中排过序,Shopify 提醒这可能会破坏图片链接。不要对产品文件排序。 |
| 条形码变成 4.00638E+12 这样的数字 | Excel 把它们四舍五入了。粘贴前先把该列设为文本格式。 |
8如何把 Shopify 产品导出为 CSV 或 Excel
Shopify 后台只能把产品导出为 CSV。根据 Shopify 帮助中心(2026年11月6日查阅),UTF-8 编码的 CSV 是它唯一能导入或导出的格式,而且导出文件不包含 Collection 列。
使用 BluePeacock,格式和列都由您选择:
- 1打开“导出”,选择“产品”;如需每个选项、价格和库存列,请选择“多属性”。
- 2挑选列,包括图片 URL 和元字段。
- 3按状态、供应商、产品类型、标签或创建日期筛选。
- 4选择 CSV 或 Excel。
- 5下载文件;付费套餐还可以发送到 FTP、SFTP、WebDAV 或 Google Drive。
- 6立即运行、稍后运行,或按重复计划运行,例如每周备份。
9如何导出 Shopify 订单
在 Shopify 后台打开“订单”,选择“导出”。根据 Shopify 帮助中心(2026年11月6日查阅),最多 50 个订单可以直接下载,更大的导出会通过电子邮件发送给您。
10如何导入和导出客户
Shopify 客户 CSV 接受姓名、电子邮件、电话、一个默认地址、营销同意、标签、备注和免税设置。根据 Shopify 帮助中心(2026年11月6日查阅),文件最大 15 MB,重复的电子邮件或电话号码会被跳过,密码无法迁移。
11可以把订单导入 Shopify 吗?
用 Shopify 后台不行。Shopify 帮助中心(2026年11月6日查阅)介绍了订单导出,但没有订单导入。
要迁移历史订单,您需要一个能创建订单的应用。BluePeacock 可以从 CSV 或 Excel 导入订单和草稿订单。Matrixify 在 Shopify App Store 上的页面(2026年11月6日查阅)也列出了订单导入功能。
12如何从其他商店导入产品
从 WooCommerce 迁移:在付费套餐中,用商店地址和 API 密钥连接您的商店,BluePeacock 就会读取其中的产品。也可以从 WooCommerce 导出产品 CSV,在任何套餐中导入该文件。
从其他任何平台迁移:导出产品 CSV,再把它的列与 Shopify 字段对应。BluePeacock 会推荐相近的匹配,但从不替您猜测。
从另一个 Shopify 商店迁移:从一个商店导出产品,再把文件导入另一个商店。
比较 Shopify 迁移和导入应用13安全运行大规模导入的方法
无论迁移什么数据,这六个步骤都能保护您的商店:
- 1导出要修改的数据作为备份。它同时也是一个列与您商店一致的模板。
- 2准备文件。加入一个标识列,例如产品 ID、handle 或 SKU,这样记录会被更新,而不是重复创建。不想修改的单元格请留空:BluePeacock 不会改动空白单元格。
- 3把每一列与一个 Shopify 字段对应。
- 4检查每一项变更。BluePeacock 会做一次不改动任何数据的测试运行,并显示每条记录修改前后的样子。
- 5立即运行或定时运行。BluePeacock 会在写入前保存每个字段的旧值。
- 6出错时撤销。打开该任务,一键即可恢复保存的旧值。已删除的图片无法恢复,因为 Shopify 会删除这些文件。
测试运行能在错误进入商店之前把它拦下。保存的旧值和一键撤销能修复漏网的错误。如果遇到困难,BluePeacock 的工作人员会在 24 小时内答复。
免费试用 BluePeacock Import & Export可迁移的商店设置、客户数据与备份
- 商店政策
- 导入和导出退款政策、隐私政策、服务条款和配送政策。
- 配送设置
- 导入和导出配送配置、区域和运费。
- 客户细分
- 导入和导出客户细分。
- 主题文件备份
- 将主题文件导出为带日期的备份。导入主题文件需要 Shopify 授予特别许可。
- 库存转移
- 导入和导出地点之间的库存转移。
- 订阅和预购计划
- 导出订阅和预购销售计划。
- Shopify Markets
- 导入和导出您的 Markets 设置。
- 商店余额
- 导出客户的商店余额。
- 弃单
- 仅支持导出。访问受保护的客户数据需要 Shopify 批准。
- 礼品卡
- 要迁移礼品卡?BluePeacock Gift Card Importer 能把礼品卡连同原始卡号和余额一起带入 Shopify。
Shopify 导入导出常见问题
如何批量导入产品到 Shopify?
制作一个 CSV 文件,每个产品、多属性或额外图片占一行,保存为 UTF-8,然后在 Shopify 后台进入“产品”并选择“导入”。如果需要导入 Excel 文件、在写入前测试运行并一键撤销,请使用 BluePeacock Import & Export 这样的导入应用。
在哪里可以找到 Shopify 产品 CSV 模板?
Shopify 帮助中心提供了示例产品 CSV 的链接。更快的做法是导出您自己的一个产品:文件里有您商店使用的所有列,顺序也一致。
为什么我的 Shopify CSV 导入失败?
常见原因是文件没有保存为 UTF-8、Excel 添加了弯引号、列表头拼写错误,或图片 URL 不公开。本指南的报错列表里有每种情况的修复方法。
Shopify CSV 导入的文件大小限制是多少?
根据 Shopify 帮助中心(2026年11月6日查阅),产品和客户 CSV 文件不能超过 15 MB。更大的文件需要拆分。
可以用 Shopify CSV 导入元字段吗?
可以。产品元字段放在以元字段命名的额外列中,例如 “Fabric (product.metafields.custom.fabric)”。根据 Shopify 帮助中心(2026年11月6日查阅),不支持多属性元字段。导入前请先创建元字段定义。
如何在 CSV 中为一个产品添加多张图片?
每张图片一行。每个额外行只填写 URL handle 和 Product image URL,并用 Image position 设定顺序。每个 URL 都必须公开。
可以把订单导入 Shopify 吗?
用 Shopify 后台不行:它的帮助中心(2026年11月6日查阅)介绍了订单导出,但没有订单导入。您需要一个能创建订单的应用。BluePeacock 可以导入订单和草稿订单。
如何把 Shopify 产品导出到 Excel?
Shopify 后台导出的是 CSV,可以用 Excel 打开。如果想得到真正的 Excel 文件并自选列,请用 BluePeacock 导出,并选择 Excel 格式。
可以撤销 Shopify CSV 导入吗?
根据 Shopify 帮助中心(2026年11月6日查阅),导入一旦开始就无法取消,也没有介绍撤销功能。BluePeacock 会在写入前保存每个字段的旧值,所以已完成的导入可以一键撤销。
关于本指南
由 BluePeacock 团队撰写。我们开发用于批量数据和礼品卡的 Shopify 应用。本文中每一条 Shopify 信息都已于2026年11月6日对照 Shopify 帮助中心核实。