使用说明

Merchant CSV Doctor 使用说明

了解 Merchant CSV Doctor 适合谁、如何检查 Shopify 商品 CSV、如何理解问题与准备度、如何应用安全修复,以及下载文件如何使用。

适合谁

为准备 Shopify 商品 CSV 的卖家而设计。

适合准备导入新商品、重新导入已编辑的 Shopify 导出文件,或在商品目录更新前做一次独立检查。它的目标是发现文件与商品结构问题,而不是替你修改业务数据。

它解决什么问题?

Shopify 商品 CSV 可能因为文件结构损坏、表头不一致、必填值缺失、变体关系、图片链接语法或格式错误而导入失败或结果异常。Merchant CSV Doctor 会在导入前于浏览器本地检查这些问题。

开始前准备

  • 使用 UTF-8 编码保存的 .csv 文件。
  • 保留一份未修改的原始文件作为备份。
  • 如果拆分大文件,同一商品的变体和附加图片应保留在同一文件中。
  • 文件在浏览器本地处理,CSV 本身不会上传到 SellerFrog。

操作步骤

如何使用 Merchant CSV Doctor

  1. 上传商品 CSV

    把 CSV 拖入上传区域,或从设备选择文件。工具会先检查文件类型、编码、表头、行结构和安全处理限制,然后再开始商品检查。

  2. 选择你的导入目的

    选择“导入新商品”或“更新现有商品”。两种场景的风险不同,例如空值和缺失列在更新已有商品时可能产生不同影响。

  3. 运行检查

    检查范围包括 CSV 结构、常见 Shopify 表头、商品与变体依赖关系、价格、图片链接语法、SEO 长度、Handle 等与导入相关的字段。

  4. 按严重程度阅读结果

    Critical(严重)表示问题可能阻止导入或明显影响结果;Warning(警告)表示文件可能仍可使用,但应人工确认;Info(提示)是说明性信息,不扣减准备度分数。

  5. 先预览,再应用安全修复

    安全修复只处理格式和明确可逆的修正。工具不会自动修改价格、SKU、库存数量、供应商、税务设置、商品类别或变体关系。

  6. 下载所需文件和报告

    下载检查后或安全修复后的 CSV 继续处理;如果需要单独的问题清单,可下载错误报告。即使文件允许下载,也仍可能存在需要你判断的事项。

如何理解准备度分数

100起始分
−15每个严重问题
−3每个警告
0提示信息扣分

这个分数是离线检查的清单分数,不代表 Shopify 一定成功导入。店铺设置、已有商品、元字段、履约配置,以及图片链接是否可访问,仍需要另外核对。

下载文件怎么使用

下载项用途
检查后 / 修复后 CSV作为下一步导入候选文件。导入 Shopify 前继续检查尚未解决的严重问题和警告。
问题报告单独保存需要人工修改或业务判断的问题清单。

导入 Shopify 前

  • 重要目录或首次处理的目录,先导入少量样本。
  • 仔细查看 Shopify 导入预览,尤其是相同 Handle 商品的覆盖行为。
  • 确认图片链接可公开访问,并核对店铺履约设置、元字段及其他店铺特有要求。

Shopify 官方商品 CSV 文档 ↗

常见问题

CSV 会离开我的浏览器吗?

不会。商品 CSV 的解析和处理都在浏览器本地完成。

工具能安全自动修复所有问题吗?

不能。价格、SKU、税费、库存、类别和变体关系等业务决策必须由你确认。

100 分是不是保证导入成功?

不是。它只表示本工具覆盖的离线检查没有发现扣分问题。