跳到正文

如何为图片文件命名

产品图片文件的唯一命名规则:如何用 SKU 等标识符命名、如何用数字后缀控制图片顺序,以及末尾空格、缺少扩展名等导致图片无法匹配的常见错误。

用图片所属的标识符为每张图片命名,可选择在后面加上下划线和表示位置的数字:<标识符>_<顺序>.<扩展名>。

规则

应用会通过三个步骤把文件名转换为匹配键:

  1. 去掉扩展名:即最后一个 . 之后的所有内容。
  2. 如果最后一个下划线后面是数字,该数字就是图片的顺序,其前面的全部内容是标识符。否则,整个文件名就是标识符。
  3. 将标识符转换为小写。 匹配时两侧都不区分大小写。

示例

文件名使用的标识符顺序说明
AB-1234.jpgab-1234第 1 张该多属性只有一张图片
AB-1234_0.jpgab-1234第 1 张_0 与不加后缀含义相同
AB-1234_1.jpgab-1234第 2 张
AB-1234_2.pngab-1234第 3 张
7891234567890_1.jpg7891234567890第 2 张按条形码/EAN 匹配
RED-SHIRT_M.jpgred-shirt_m第 1 张M 不是数字,因此保留在标识符中
AB_12_3.jpgab_12第 4 张只有最后一段才表示顺序
AB-1234.v2.jpgab-1234.v2第 1 张只有最后一个点之后的内容才是扩展名
AB-1234(空)无永远无法匹配。 文件必须有扩展名

图片顺序

用数字后缀控制图库顺序:

AB-1234_0.jpg  →  第 1 张(同时作为多属性图片)
AB-1234_1.jpg  →  第 2 张
AB-1234_2.jpg  →  第 3 张
  • 只有相对顺序才有意义。 _1, _3, _7 与 _1, _2, _3 的顺序相同。
  • 没有后缀即为第一张。 AB-1234.jpg 和 AB-1234_0.jpg 等价,不要同时使用。
  • 数字最小的图片会成为多属性图片。 请为主图设置最小的数字。
  • 不使用替换模式时,新图片会追加在产品现有图片之后。
  • 超过 999 的顺序数字会被截断。

建议做法

  • 标识符与 Shopify 中完全一致(大小写不限,其余必须相同)。
  • 统一使用 _0, _1, _2… 或 _1, _2, _3…。
  • 使用 .jpg、.jpeg、.png、.webp 或 .gif。
  • 同一文件夹内的文件名保持唯一。

应避免的做法

  • 末尾不要加空格(AB-1234 .jpg)。空格会成为标识符的一部分。Shopify 中的值会去除首尾空格,但文件名不会。
  • 文件名不要以下划线开头(_AB-1234.jpg)。
  • 不要上传没有扩展名的文件。
  • 不要用字母表示顺序(AB-1234_a.jpg 查找的是 ab-1234_a)。
  • 同一文件夹不要混用规则(部分文件用 _1,部分用 -1)。

文件名与 SKU 对不上时

不一定要重命名成千上万个文件:

  • 文件名带有额外文字时,使用**“包含”**类匹配(请参阅 匹配类型)。
  • 把图片编码写入元字段,并按元字段匹配。
  • 文件名不统一时,使用 AI 匹配(测试版)。
  • 请我们设置标识符清理规则,例如忽略 SKU 中第一个连字符之后的内容。