检查器会检查什么
检查器解析 UTF-8 逗号分隔数据,并支持 BOM、带引号的逗号、转义引号和引号内换行。它检查表头、Handle、变体选项组合、指定数值字段、库存整数、图片 URL 外观,以及简单的商品和 SEO 文案信号。每条结果都包含 CSV 记录行号、列名、说明和建议操作。
规则快照根据 Shopify 公开的商品 CSV 指南和常见导入问题文档整理,核对日期为 2026 年 10 月 13 日。Shopify 当前格式包含动态市场列和商家自定义 metafield 列,因此未知表头会保留,不会仅因未知而被判错。本工具只检查 Shopify 商品 CSV,不校验 Google Merchant Center Feed。
错误、警告与建议
错误表示需要明确复核的结构或值,例如 Handle 为空、表头重复或价格不是数值。警告表示可能存在风险、但依赖具体情境,例如 SKU 为空或重复、缺少 Title,或变体身份不一致。空 SKU 和重复 SKU 默认不会被判为导入失败。建议项包括 SEO 文案长度、Body HTML 复核、同名商品使用不同 Handle;这些不是 Shopify 导入规则。
Shopify 要求会因新建商品或更新现有商品而变化。例如 Title 和 Handle 在不同流程中的要求不同,变体字段也依赖选项列。请结合下方官方文档确认你的实际导入方式。
预览与修复不会覆盖源文件
预览会展示识别到的表头和前几条非空记录,并保留单元格原始内容。点击问题可以跳转到对应行。检查报告只包含诊断结果,不包含商品字段值。
可选修复可以移除全空行,并清理部分非保护字段首尾空格。导出前会逐格展示差异。Handle、Title、SKU、价格、成本、库存、选项、税务字段和商品描述不会被清理。确认后下载的是另一份新 CSV,原始文件保持不变。
导入前的实用检查步骤
从最新商品导出文件或 Shopify 当前示例模板开始,将准备导入的文件表头逐一核对。先处理错误,再判断警告是否来自有意设置的商品目录规则。建议项可作为编辑复核,尤其是 SEO 字段和重复商品标题。
导入前确认 Shopify 操作流程正确,逐个检查变体选项是否能唯一识别,并保留源文件副本。看起来完整的图片 URL 不代表 Shopify 一定能下载。本工具不会访问图片服务器或 Shopify。