Python Pillow批量图片水印脚本实现文字Logo与平铺

脚本专家

批量处理图片水印是开发中常见的自动化需求，尤其当图片数量达到数千张时，手动操作几乎不可行。Python 的 Pillow 库提供了完整的图像处理接口，可以基于透明图层叠加的方式，快速实现文字水印、Logo 水印以及全屏平铺水印。本文从实际代码出发，给出三个可复用的水印函数，并提供一个通用的批量处理入口，适合直接嵌入到自动化流程中。

2. # 基础环境
3. pip install Pillow

复制代码

核心思路是：打开原图并转换为 RGBA 模式，创建一张同尺寸的透明图层，在透明图层上绘制文字或粘贴 Logo，再通过 Image.alpha_composite 将图层与原图合成，最后按需转换为 RGB 保存。全程不修改原文件，输出到指定目录。

文字水印实现
文字水印通过 ImageDraw.text 绘制，支持自定义内容、位置、字号、颜色透明度以及旋转角度。字体默认读取 Windows 下的微软雅黑 msyh.ttc，如果不存在则回退到默认字体。注意，若要在 Linux 或 macOS 上运行，需要将字体路径替换为系统中实际存在的中文字体文件，否则中文会显示为方框。

2. from PIL import Image, ImageDraw, ImageFont
3. import os
4. from pathlib import Path
6. def add_text_watermark(input_image, output_image, text="内部资料",
7.                        position="center", font_size=40, color=(255, 255, 255, 128),
8.                        angle=0):
9.     img = Image.open(input_image).convert('RGBA')
10.     txt_layer = Image.new('RGBA', img.size, (255, 255, 255, 0))
11.     draw = ImageDraw.Draw(txt_layer)
13.     try:
14.         font = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", font_size)
15.     except:
16.         font = ImageFont.load_default()
18.     bbox = draw.textbbox((0, 0), text, font=font)
19.     text_width = bbox[2] - bbox[0]
20.     text_height = bbox[3] - bbox[1]
22.     positions = {
23.         'center': ((img.width - text_width) // 2, (img.height - text_height) // 2),
24.         'bottom-right': (img.width - text_width - 20, img.height - text_height - 20),
25.         'bottom-left': (20, img.height - text_height - 20),
26.         'top-right': (img.width - text_width - 20, 20),
27.         'top-left': (20, 20),
28.     }
29.     x, y = positions.get(position, positions['center'])
31.     if angle != 0:
32.         big_layer = Image.new('RGBA', (img.width * 2, img.height * 2), (255, 255, 255, 0))
33.         big_draw = ImageDraw.Draw(big_layer)
34.         big_draw.text((img.width // 2, img.height // 2), text, font=font, fill=color)
35.         big_layer = big_layer.rotate(angle, expand=0)
36.         txt_layer = big_layer.crop((img.width // 2, img.height // 2,
37.                                     img.width // 2 + img.width,
38.                                     img.height // 2 + img.height))
39.     else:
40.         draw.text((x, y), text, font=font, fill=color)
42.     result = Image.alpha_composite(img, txt_layer)
43.     result = result.convert('RGB')
44.     result.save(output_image, quality=95)
45.     print(f"文字水印: {os.path.basename(input_image)}")

复制代码

旋转处理的原理是先把文字画在一张比原图大四倍的透明画布中心，再旋转整张画布，最后裁剪出与原图等大的区域。这样可以避免旋转后文字超出边界。

Logo 图片水印实现
图片水印适合放公司 Logo，支持透明度调整和等比缩放。建议使用 PNG 透明背景，否则会带白色底块。缩放时根据原图宽度乘以 scale 计算宽度，高度按 Logo 原始宽高比计算，保证不变形。透明度控制通过修改 alpha 通道实现。

2. def add_image_watermark(input_image, output_image, logo_path,
3.                         position="bottom-right", opacity=0.5, scale=0.15):
4.     img = Image.open(input_image).convert('RGBA')
5.     logo = Image.open(logo_path).convert('RGBA')
7.     new_logo_size = (int(img.width * scale),
8.                      int(img.height * scale * logo.height / logo.width))
9.     logo = logo.resize(new_logo_size, Image.LANCZOS)
11.     if opacity < 1:
12.         r, g, b, a = logo.split()
13.         a = a.point(lambda x: int(x * opacity))
14.         logo = Image.merge('RGBA', (r, g, b, a))
16.     positions = {
17.         'center': ((img.width - logo.width) // 2, (img.height - logo.height) // 2),
18.         'bottom-right': (img.width - logo.width - 20, img.height - logo.height - 20),
19.         'bottom-left': (20, img.height - logo.height - 20),
20.         'top-right': (img.width - logo.width - 20, 20),
21.         'top-left': (20, 20),
22.     }
23.     x, y = positions.get(position, positions['bottom-right'])
25.     watermark_layer = Image.new('RGBA', img.size, (0, 0, 0, 0))
26.     watermark_layer.paste(logo, (x, y))
28.     result = Image.alpha_composite(img, watermark_layer)
29.     result = result.convert('RGB')
30.     result.save(output_image, quality=95)
31.     print(f"Logo水印: {os.path.basename(input_image)}")

复制代码

平铺水印实现
对于防泄漏需求，可以将文字错落铺满全图。通过两个 while 循环按行列绘制，行号奇偶时偏移半个间距，形成类似砖墙的排列方式。适合对文档截图声明“机密文件”之类的场景。

2. def add_tiled_watermark(input_image, output_image, text="内部资料",
3.                          font_size=30, color=(255, 255, 255, 50), angle=-30, spacing=150):
4.     img = Image.open(input_image).convert('RGBA')
5.     txt_layer = Image.new('RGBA', img.size, (255, 255, 255, 0))
6.     draw = ImageDraw.Draw(txt_layer)
8.     try:
9.         font = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", font_size)
10.     except:
11.         font = ImageFont.load_default()
13.     bbox = draw.textbbox((0, 0), text, font=font)
14.     text_width = bbox[2] - bbox[0]
15.     text_height = bbox[3] - bbox[1]
17.     y = 0
18.     while y < img.height:
19.         x = 0
20.         row_offset = (y // spacing) % 2 * (spacing // 2)
21.         while x < img.width:
22.             draw.text((x + row_offset, y), text, font=font, fill=color)
23.             x += text_width + spacing
24.         y += text_height + spacing
26.     result = Image.alpha_composite(img, txt_layer)
27.     result = result.convert('RGB')
28.     result.save(output_image, quality=95)
29.     print(f"平铺水印: {os.path.basename(input_image)}")

复制代码

批量处理入口
三个函数都接收 input_image 和 output_image 路径，因此可以统一封装批量处理函数。只需要遍历输入目录下的图片文件，调用对应水印函数即可。支持 jpg、png、bmp、webp、tiff 等常见格式。

2. def batch_add_watermark(input_dir, output_dir, watermark_func, **kwargs):
3.     input_path = Path(input_dir)
4.     output_path = Path(output_dir)
5.     output_path.mkdir(parents=True, exist_ok=True)
7.     image_extensions = {'.jpg', '.jpeg', '.png', '.bmp', '.webp', '.tiff'}
8.     count = 0
10.     for file_path in input_path.iterdir():
11.         if file_path.is_file() and file_path.suffix.lower() in image_extensions:
12.             output_file = output_path / file_path.name
13.             watermark_func(str(file_path), str(output_file), **kwargs)
14.             count += 1
16.     print(f"\n批量水印完成: {count} 张图片")

复制代码

使用示例
批量给员工工牌照片添加“仅限内部使用”文字水印：

2. if __name__ == "__main__":
3.     batch_add_watermark(
4.         input_dir="原始工牌照片",
5.         output_dir="已加水印",
6.         watermark_func=add_text_watermark,
7.         text="仅限内部使用",
8.         position="center",
9.         font_size=40,
10.     )

复制代码

批量给产品图片添加 Logo：

2. # batch_add_watermark(
3.     #     input_dir="产品图片",
4.     #     output_dir="已加Logo",
5.     #     watermark_func=add_image_watermark,
6.     #     logo_path="company_logo.png",
7.     #     position="bottom-right",
8.     #     opacity=0.7,
9.     #     scale=0.1
10.     # )

复制代码

对机密文档截图做全屏平铺水印：

2. # batch_add_watermark(
3.     #     input_dir="机密文档截图",
4.     #     output_dir="平铺水印",
5.     #     watermark_func=add_tiled_watermark,
6.     #     text="机密文件",
7.     #     font_size=25,
8.     #     angle=-30,
9.     # )

复制代码

常见问题与排查
中文水印显示为方框，原因是代码找不到中文字体。解决方法是显式指定系统中文字体路径，比如微软雅黑 msyh.ttc 或宋体 simsun.ttc。

水印太显眼时，调节 color 元组的第四个参数 alpha 值，例如 (255, 255, 255, 50) 表示透明度较高。

保存 PNG 后水印丢失，这是因为合成的结果是 RGBA 模式，如果直接保存为 PNG 通常正常；但如果想保留透明通道，应使用 result.save(output_image, 'PNG')，不要转换为 RGB。

整体来看，Pillow 的水印方案足够应对大多数批量场景。通过替换字体路径和调整透明度、位置、缩放比例，可以灵活适配不同业务需求。对于需要更高性能的场景，可以考虑 multiprocessing 并行处理多个文件，但要注意 Pillow 线程安全性，推荐使用进程池。