Python|批量把图片转成 800×800 白底正方形(支持子文件夹,可保留目录结构)

用 Python 和 Pillow,把一个目录下的所有图片(包括各级子文件夹里的)统一处理成 800×800 的白底正方形图。输出方式有两种,改脚本里的一个设置即可切换:

  • 保持原来的文件夹结构(默认):适合按商品、按相册分类的图片
  • 集中输出到同一个文件夹:适合需要把所有图片放在一起上传的场景

效果说明

假设目录结构如下:

photo/
├── resize_to_square.py
├── root.jpg
├── 商品A/
│   ├── 1.jpg
│   └── 细节/t.png
└── 商品B/1.jpg

保持文件夹结构时(keep_structure = True):

photo/800x800_done/
├── root.jpg
├── 商品A/
│   ├── 1.jpg
│   └── 细节/t.jpg
└── 商品B/1.jpg

集中输出时(keep_structure = False):

photo/800x800_done/
├── root.jpg
├── 商品A_1.jpg
├── 商品A_细节_t.jpg
└── 商品B_1.jpg

处理规则:

  1. 递归扫描脚本所在目录下的所有图片,原图不会被改动
  2. 等比例缩放,最长边不超过 800 像素
  3. 居中放在 800×800 的白色画布上,长方形图的上下(或左右)自动补白
  4. 统一保存为 JPG(质量 95),输出到 800x800_done 文件夹
  5. 同名图片自动编号(例如 1.jpg 和 1.png 会得到 1.jpg 和 1_1.jpg),不会互相覆盖

准备工作

需要先安装 Python 3 和 Pillow(9.1 以上版本):

pip install Pillow

第一步:创建脚本文件

在图片所在的根目录(例如 photo)新建一个文本文档,另存为 resize_to_square.py。保存时「保存类型」选「所有文件」,编码选 UTF-8。

第二步:粘贴代码

用记事本打开 resize_to_square.py,复制以下代码。脚本放在哪个目录,就处理哪个目录,不需要修改路径。

import os
from PIL import Image, ImageOps

# ========== 可修改的设置 ==========
keep_structure = True     # True:保持原来的文件夹结构;False:所有图片集中输出到同一个文件夹
target_size = (800, 800)
bg_color = (255, 255, 255)   # 白色背景
allow_upscale = False        # True:小于 800 的图片也放大到 800
valid_extensions = ('.jpg', '.jpeg', '.png', '.webp', '.bmp', '.jfif')
# =================================

# 自动获取脚本所在目录:把脚本放在图片所在的根目录即可,无需修改路径
base_dir = os.path.dirname(os.path.abspath(__file__))
output_name = '800x800_done'
output_folder = os.path.join(base_dir, output_name)
os.makedirs(output_folder, exist_ok=True)

print("----------------------------------------")
print(f"正在扫描文件夹(含所有子文件夹): {base_dir}")

count = 0
used_paths = set()

for root, dirs, files in os.walk(base_dir):
    # 不进入自己生成的输出文件夹
    dirs[:] = [d for d in dirs if d != output_name]
    rel_dir = os.path.relpath(root, base_dir)

    for file in sorted(files):
        if not file.lower().endswith(valid_extensions):
            continue
        file_path = os.path.join(root, file)

        try:
            with Image.open(file_path) as img:
                # 按 EXIF 信息校正方向(手机照片)
                img = ImageOps.exif_transpose(img)

                # 透明背景先合成到白底,避免透明区域变黑
                if img.mode in ("RGBA", "LA") or (img.mode == "P" and "transparency" in img.info):
                    img = img.convert("RGBA")
                    flat = Image.new("RGB", img.size, bg_color)
                    flat.paste(img, mask=img.split()[-1])
                    img = flat
                else:
                    img = img.convert("RGB")

                # 等比例缩放,最长边不超过 800
                if allow_upscale:
                    img = ImageOps.contain(img, target_size, Image.Resampling.LANCZOS)
                else:
                    img.thumbnail(target_size, Image.Resampling.LANCZOS)

                # 创建 800x800 白色画布并居中粘贴
                canvas = Image.new("RGB", target_size, bg_color)
                canvas.paste(img, ((target_size[0] - img.width) // 2,
                                   (target_size[1] - img.height) // 2))

                # 确定输出位置
                stem = os.path.splitext(file)[0]
                if keep_structure:
                    out_dir = output_folder if rel_dir == "." else os.path.join(output_folder, rel_dir)
                else:
                    out_dir = output_folder
                    if rel_dir != ".":   # 文件名加上文件夹名前缀,避免同名覆盖
                        stem = rel_dir.replace(os.sep, "_") + "_" + stem
                os.makedirs(out_dir, exist_ok=True)

                # 同名(如 a.png 和 a.jpg)时自动编号,避免覆盖
                out_path = os.path.join(out_dir, stem + ".jpg")
                n = 1
                while out_path.lower() in used_paths:
                    out_path = os.path.join(out_dir, f"{stem}_{n}.jpg")
                    n += 1
                used_paths.add(out_path.lower())

                canvas.save(out_path, "JPEG", quality=95)
                count += 1
                print(f"[{count}] {os.path.relpath(file_path, base_dir)} -> {os.path.relpath(out_path, output_folder)}")
        except Exception as e:
            print(f"[失败] {os.path.relpath(file_path, base_dir)}: {e}")

print("----------------------------------------")
print(f"处理完成!共成功转换 {count} 张图片。")
print(f"请打开此文件夹查看结果: {output_folder}")

第三步:运行脚本

按 Win + R,输入 cmd 后回车,执行:

python C:\Users\<用户名>\Downloads\photo\resize_to_square.py

也可以先输入 python (后面带一个空格),再把 .py 文件直接拖进命令提示符窗口。运行结束后,photo 目录下会出现 800x800_done 文件夹,里面就是处理好的图片。

注意事项

  • 会扫描所有子文件夹,包括更深层的。只想处理某一个文件夹,就把脚本放进那个文件夹里运行。
  • 默认不放大小图。 小于 800 像素的图片只会居中放到白色画布上,想放大就把 allow_upscale 改成 True。
  • 统一输出为 JPG。 PNG 的透明区域会变成白色。
  • 重复运行不会处理已生成的结果。 同名文件会被覆盖,原图不受影响。

常见问题

提示 python 不是内部或外部命令?
说明 Python 没有加入系统路径。可以改用 py 代替 python,或重新安装并勾选「Add Python to PATH」。

提示 No module named PIL?
没有安装 Pillow,执行 pip install Pillow 即可。

想抠图换白底,而不是补白边?
见 Python|自动化批量处理产品图片:一键抠图换白底并统一尺寸(基于 rembg)。

更多文章