文档中心

对象存储

图片处理

创建图片样式

创建图片样式

图片样式是指包含格式转换、渐进显示等多个图片处理参数的一个模板。您可以使用图片样式统一处理多个图片，达到简化操作的目的。本文介绍使用图形化界面和代码的方式创建图片样式的相关操作。

使用图形化界面创建样式

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，选择数据处理 > 图片处理。

在图片处理页面，单击样式页签，然后单击创建样式。

在创建样式页面基础编辑按钮下，设置如下参数，单击确定。

说明

设置样式参数时，您可以在创建样式页面右侧预览参数处理后的图片效果，以及对应的代码。

参数	说明	约束限制
规则名称	设置样式的名称。命名规范如下：只能以大小写字母、数字、下划线（_）开头。只能包含数字、大小写字母、下划线（_）、中划线（-）以及英文句号（.）。长度限制为 1~256 个字符。	最多可以创建 100 个样式。样式名称可以相同，如果您想为同一个样式配置多个规则生效前缀时，您需要创建多个名称相同的样式。
规则生效前缀	设置样式生效的对象前缀，若没有填写，则默认对桶内所有对象生效。前缀的填写规范如下：支持中文、英文、数字及常见字符。不支持以正斜线（/）或反斜线（\）开头，不支持使用连续的正斜线（/）。不支持使用 .. 作为目录名称。	同一个样式最多配置 10 个不同的规则生效前缀，且前缀之间不能存在包含关系，例如为同一个样式设置多个规则生效前缀时，前缀 1 设置为 event，则前缀 2 不支持设置为 event/test。您可以创建多个名称相同的样式，然后为其中的每个样式配置不同的规则生效前缀，实现同一个样式处理不同前缀的图片，效果不同。
格式转换	设置图片转换的格式，支持原图格式、jpg、jpeg、png、bmp、gif、webp 或 tiff 格式。默认为原图格式。	-
渐进显示	选择是否开启先模糊后清晰的呈现方式，即先显示整个图片的模糊轮廓，然后逐渐加载直至显示完整的图片。默认关闭渐进显示。	仅对格式为 JPG 的图片有效。
自适应方向	选择是否根据原图中 EXIF 旋转参数进行旋转。默认开启自适应方向。	如果原图没有旋转参数，则自适应方向功能无效且对图片无任何影响。
图片质量	选择是否对原图进行压缩，调整原图的质量。默认为相对质量，且压缩百分比为 90。参数说明如下：相对质量：将图片按照原图的 q% 进行压缩。绝对质量：直接将图片压缩为 Q%，与原图不存在相对关系，不依赖于原图。不压缩：对原图不进行压缩。	图片质量仅对 JPG 和 WEBP 格式的图片有效。对于 WEBP 格式的图片，相对质量等价于绝对质量，即相对质量和绝对质量的效果相同。
缩略方式	选择是否对图片进行缩放。不使用缩略（默认）等比例缩小等比例放大指定宽高缩放宽度固定，高度自适应：根据固定宽度等比例缩放图片。高度固定，宽度自适应：根据固定高度等比例缩放图片。固定宽高，按长边缩放：根据固定宽高构造一个矩形框，对原图进行等比缩放，缩放过程中全部落入矩形框中的最大图片。固定宽高，按短边缩放：根据固定宽高构造一个矩形框，对原图进行等比缩放，缩放过程中完全覆盖矩形框的最小图片。固定宽高，缩略填充：根据固定宽高构造一个矩形框，对原图进行等比缩放，首先确定完全落入矩形框的最大图片，然后在矩形框内居中放置该图片，并对剩余空白区域进行颜色填充。固定宽高，居中裁剪：根据固定宽高构造一个矩形框，对原图进行等比缩放，首先确定完全覆盖矩形框的最小图片，然后按照矩形框大小进行居中裁剪。强制宽高：根据固定宽度和高度缩放图片。	-
图片亮度	设置图片的亮度。取值范围为 -100 ~ 100，默认为 0。取值说明如下：取值＜0：降低图片亮度。取值 =0：不调整图片亮度。取值＞0：提高图片亮度。	-
图片对比度	设置图片的对比度。取值范围为 -100 ~ 100，默认为 0。取值说明如下：取值＜0：降低图片对比度。取值 =0：维持原图对比度。取值＞0：提高图片对比度。	-
图片锐化	调整图片的清晰度。取值范围为 50~399，默认关闭图片锐化。取值越大，图片越清晰，但过大的值可能会导致图片失真。为达到较优效果，推荐取值 100。	-
图片模糊	选择是否为图片增加模糊效果，默认关闭图片模糊。开启图片模糊后，需要设置以下参数：模糊半径：取值范围为 1~50，该值越大，图片越模糊。模糊标准差：取值范围为 1~50，该值越大，图片越模糊。	-
图片旋转	设置图片顺时针旋转的角度。取值范围为 0~360，默认为 0。若图片旋转的角度不是 90°、180°、270°、360° 时，会导致处理后的图片尺寸变大。	旋转功能要求图片的宽或高不能超过 4096 px。
水印	选择是否为图片添加图片水印和文字水印，不支持同时设置图片水印和文字水印。默认为不使用水印。部分参数说明如下：图片水印选择图片水印后，设置水印图路径、水印图预处理、透明度等参数。其中：水印图路径：存储桶中图片的路径，例如水印图片的名称为 abc.jpg，并且放在存储桶的 test 文件夹下，则水印图的路径为 test/abc.jpg。占比：水印图占图片大小的百分比。开启水印图预处理功能后，可以设置占比。垂直边距：水印图与图片下边的距离。该参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。水平边距：水印图与图片右侧边的距离。该参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。文字水印选择文字水印后，设置文字的内容、字体、文字大小、文字顺时针旋转的角度等参数。部分参数说明如下：文字内容：仅支持 16 个以内字符。文字字体：可选字体为默认字体（即文泉驿正黑）、文泉驿正黑、文泉微米黑、方正书宋、方正楷体、方正黑体、方正仿宋、DroidSansFallback。垂直边距：文字与图片下边的距离。该参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。水平边距：文字与图片右侧边的距离。该参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。	图片水印如果您想预览水印效果，需要将水印图片的访问权限设置为公共读。水印图与原图必须处于同一个存储桶，否则图片水印会失败。
去除元信息	是否去除图片元信息。	仅支持去除图片的 bKGD、cHRM、EXIF、gAMA、iCCP、iTXt、tEXt、zCCP、zTXt 信息。去除图片元信息时，会去除图片的所有元信息，不支持保留个别元信息。

使用代码创建样式

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，选择数据处理 > 图片处理。

在图片处理页面，单击样式页签，然后单击创建样式。

在创建样式页面，单击高级编辑按钮，设置如下参数，单击确定。

参数	说明	约束限制
规则名称	设置样式的名称。命名规范如下：只能以大小写字母、数字、下划线（_）开头。只能包含数字、大小写字母、下划线（_）、中划线（-）以及英文句号（.）。长度限制为 1~256 个字符。	最多可以创建 100 个样式。样式名称可以相同，如果您想为同一个样式配置多个规则生效前缀时，您需要创建多个名称相同的样式。
规则生效前缀	设置样式生效的对象前缀，若没有填写，则默认对桶内所有对象生效。前缀的填写规范如下：支持中文、英文、数字及常见字符。不支持以正斜线（/）或反斜线（\）开头，不支持使用连续的正斜线（/）。不支持使用 .. 作为目录名称。	同一个样式最多配置 10 个不同的规则生效前缀，且前缀之间不能存在包含关系，例如为同一个样式设置多个规则生效前缀时，前缀 1 设置为 event，则前缀 2 不支持设置为 event/test。您可以创建多个名称相同的样式，然后为其中的每个样式配置不同的规则生效前缀，实现同一个样式处理不同前缀的图片，效果不同。
代码	输入代码，格式为 image/action1,param_value1/action2,param_value2/...，例如指定缩放宽度为 200 的对应代码为 image/resize,w_200。目前已支持的图片处理参数，请参见图片处理参数。	-

后续步骤

图片样式创建成功后，您可以使用图片样式处理图片。具体操作，请参见使用图片样式。

相关操作

导出样式

在图片处理页面，勾选样式，单击导出样式，即可将样式文件保存至本地。

导入样式

在图片处理页面，单击导入样式，在本地选择样式文件，单击打开，即可导入样式。

说明

导入的样式文件必须为 txt 格式，大小不能超过 256KB，且内容要符合样式规范。

最近更新时间：2026.10.19 18:41:14

这个页面对您有帮助吗？

有用

有用

无用

无用