跳过导航,直接阅读主要内容
UTHEME Logo

WooCommerce批量上传商品教程:CSV字段、图片和变体

阅读需要 9 分钟

WooCommerce批量上传商品教程:CSV字段、图片和变体 不是一个单纯的后台按钮问题,而是独立站运营里非常具体的一段业务流程。对 正在搭建或运营独立站的 WordPre...

要用 WooCommerce 批量上传商品,直接用后台内置的产品 CSV 导入导出即可,不必先装第三方插件。准备 UTF-8 编码的 CSV,按官方字段写好 Type、SKU、Name、价格、库存、Images 以及变体属性,再到「产品」→「所有产品」点「导入」做列映射,就能新建或更新简单商品和变体。截至 2026 年 11 月,WooCommerce 11.2 起在 ID、SKU 都为空时还可用 GTIN/UPC/EAN/ISBN 匹配已有商品。下面按字段、图片和变体说明怎么写、怎么导,以及常见报错怎么处理。

环境与 CSV 模板怎么准备

先确认站点能稳定跑导入。当前推荐环境一般是 WordPress 6.9 及以上、PHP 8.3 及以上(仍兼容更低版本但风险更高)、MySQL 8.0 或 MariaDB 10.6 及以上,并保证 HTTPS、内存不宜过低。大批量导入吃内存和执行时间,站点本身已经偏慢时,先看一下服务器线路与 WordPress 加速是否需要调整,再开导入。

内置导入导出自 WooCommerce 3.1 起就在核心里,入口在后台「产品」→「所有产品」旁的「导入」「导出」。最稳妥的做法是先导出一份现有商品 CSV 当模板:只改数据行,表头尽量保持原样,减少映射出错。也可以按官方 Schema 自己建表;需要对照样本时,可到 WooCommerce 仓库的 sample-data 目录查看示例文件。导入前务必备份,并优先在测试站跑一遍。

  • CSV 用 UTF-8;布尔值用 1/0;多值用英文逗号分隔,值里本身有逗号时加双引号。
  • 分类层级用 >,多个分类用逗号;引用已有商品可用 id:数字,SKU 一般直接写。
  • 自定义纯文本元数据可用 meta:键名;复杂序列化数据内置工具不适用。
  • Excel 常改编码或把长数字变成科学计数,导入前用文本编辑器或 Google 表格再核一遍。

字段细则以 WooCommerce 产品 CSV 导入导出官方文档 和 Product CSV Import Schema 为准。更细的 WordPress / WooCommerce 操作也可在跨境独立站技术知识库按主题查找。

WooCommerce 官方产品 CSV 导入导出文档页面截图
WooCommerce 官方产品 CSV 导入导出文档页面截图(截图来源:woocommerce.com)

核心 CSV 字段怎么填

表头名称要和导入器能识别的列一致;下面是独立站批量上架最常用的一批。新建商品时 ID 留空;更新时填已有 ID 或靠 SKU(以及 11.2 起的全球唯一编码)匹配,并勾选「更新现有商品」。

字段(表头) 是否关键 填写示例 说明
ID 更新时建议 123 新建留空;更新按 ID 优先匹配
Type 是 simple / variable / variation 还可写 grouped、external;可叠加 virtual、downloadable
SKU 强烈建议 TSHIRT-BLK-M 全店唯一;变体也要有独立 SKU 或按规则留空
Name 是 经典纯棉 T 恤 父商品与简单商品必填;变体行可省略名称
Published 建议 1 1 发布,0 私密,-1 草稿,2 待审
Short description / Description 推荐 摘要与详情 详情可含安全的 HTML;注意换行与引号不要弄乱 CSV
Categories / Tags 推荐 男装>T恤 层级用 >;多个用逗号
Images 推荐 https://cdn.example.com/a.jpg,https://cdn.example.com/b.jpg 逗号分隔;第一张为特色图,其后为图库
In stock? 建议 1 1 有货,0 无货;不要和库存数量列混用
Stock 管库存时 50 库存数量;启用库存管理时填写
Regular price / Sale price 售卖时 29.99 / 19.99 不要带货币符号;小数点用英文点
Parent 变体必填 TSHIRT-BASE 或 id:123 变体行指向父商品 SKU 或 ID
Attribute 1 name / value(s) 变体必填 颜色 / 黑,白,灰 父行列出全部可选值;变体行只写该行的单个值
GTIN, UPC, EAN, ISBN 可选 相应编码 WooCommerce 11.2+ 可在 ID、SKU 为空时用于匹配

父商品行还可写 Attribute 1 visible、Attribute 1 global、Attribute 1 default 等;需要多个属性时按 Attribute 2、Attribute 3 递增。重量尺寸、运费类、追加销售、下载文件、税类等按业务需要加列即可,不必一次塞满。

WooCommerce批量上传商品教程:CSV字段、图片和变体流程图

图片批量导入要注意什么

Images 列不接受本机路径,只接受已在媒体库中的文件名,或可直接访问的完整 URL。外链图片导入时会下载进媒体库;第一张当特色图,后面进产品图库。变体行也可以单独写 Images,让切属性时换图。

  • URL 必须可公开访问,避免登录墙、防盗链、多次跳转;尽量全程 https。
  • 单元格里不要有首尾空格;多图用英文逗号分隔。
  • 原图建议足够清晰(宽度常见会做到 800px 以上再让 WooCommerce 生成缩略图),具体裁剪以主题设置为准。
  • 核心导入器一般不能顺便改图片 Alt;需要 SEO 友好的替代文本时,导入后到媒体库补,或结合站内的SEO 技术说明统一规划标题、描述与图片信息。
  • 部分主机禁止远程拉取;失败就先把图上传到本站媒体库,再在 CSV 里写文件名或本站 URL。
按颜色尺码整理商品图与 CSV 的场景

变体商品怎么写 CSV 并完成导入

可变商品至少包含:一行 Type 为 variable 的父商品,以及多行 Type 为 variation 的子变体。父行要写全属性名和全部可选值;每个变体行写 Parent,并给每个属性只填一个值。WooCommerce 11.1 起,同一文件里父行写在变体行前面时,可一次导入创建新变体,也可把简单商品转成可变商品(仍建议先在测试站验证)。

  1. 建父行:Type 填 variable,写 Name、SKU(如 TSHIRT-BASE)、分类、描述等。Attribute 1 name 填「颜色」,Attribute 1 value(s) 填「黑,白,灰」;Attribute 2 name 填「尺码」,value(s) 填「S,M,L」。按需设置 visible、global、default。
  2. 建变体行:每行一个组合,Type 填 variation,Parent 填父 SKU 或 id:父ID。Attribute 1 value(s) 只写「黑」,Attribute 2 只写「S」,并给该行独立 SKU、价格、库存、图片。
  3. 继续写完所有组合。属性名、大小写和父行保持一致,去掉多余空格和公式残留。
  4. 后台打开「产品」→「所有产品」→「导入」,上传 CSV。可设分隔符、是否沿用上次映射;高级选项里也能指定服务器上的文件路径(受上传限制或类型拦截时有用)。
  5. 检查列映射,对不上的列手动指定或选不导入。若要改已有商品,勾选更新现有商品。然后运行导入,看完成摘要和失败日志。
  6. 到父商品编辑页的「变体」里核对数量、价格、库存和图片;前台切换属性,确认展示与库存跟随变化。

文件很大时不要一次丢几千行:按分类或 SKU 段拆批,导入间隙观察服务器负载。超时、内存不足往往是环境限制,不是字段写错;需要时再调整 PHP 执行时间与内存,而不是硬堆插件。一般店铺用内置工具即可;只有大量自定义字段、特殊分类法时,才考虑官方付费的 Product CSV Import Suite。

常见问题

导入后父商品只有「选择选项」,属性选不了?

多半是父商品属性没有正确当作变体属性写入,或前台用于变体的设置未生效。回到父商品编辑页,确认属性名称与 CSV 一致并用于变体,保存后再查看变体列表;必要时小范围重导该父 SKU 下的变体行。

价格变成 0,或库存和有货状态不对?

价格列不要带 ¥、$ 等符号,小数点用英文点。有货状态写在 In stock?(1/0),数量写在 Stock,两列不要混成一列。用 Excel 时注意单元格是否被格式化成文本以外的类型。

提示文件类型不允许,或图片全部失败?

CSV 里若夹杂异常 HTML,或主机限制上传类型,容易报文件类型不允许:可把文件先传到站点 uploads 再用服务器路径导入,并确认扩展名与真实格式一致。图片失败则逐条在浏览器打开 URL,排除防盗链、http/https 混用和重定向;改成本站媒体库资源通常最稳。

如何只更新价格或库存,又怎样避免超时?

先导出需要改的商品,保留 ID 或 SKU,只改正要改的列,导入时勾选更新现有商品。匹配顺序一般是 ID、SKU 优先,11.2 起才轮到全球唯一编码。超过约数百行仍超时,就拆文件,并检查主机上传大小与 PHP 限制;长期大批量更依赖服务器与缓存策略是否合理,而不是反复重试同一超大文件。

批量上架的关键是:用导出或官方 Schema 固定表头,分清 In stock? 与 Stock,变体用 Parent 加 Attribute N 列且父行在前,图片只用可访问的 https 地址或媒体库文件。先在测试站用几十行验证映射和变体切换,再拆批导入正式站;字段吃不准时以官方文档和 Schema 为准,站点性能不够时先处理环境和缓存,再扩大单次导入量。

咨询我们