用 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
处理规则:
- 递归扫描脚本所在目录下的所有图片,原图不会被改动
- 等比例缩放,最长边不超过 800 像素
- 居中放在 800×800 的白色画布上,长方形图的上下(或左右)自动补白
- 统一保存为 JPG(质量 95),输出到
800x800_done文件夹 - 同名图片自动编号(例如
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)。