服务器执行图片批处理：image_compress.py

1. import os
   
2. import sys
   
3. from PIL import Image
   
4. from tqdm import tqdm
   
5. import traceback
   
6. 
   
7. # 配置项（可根据需要修改）
   
8. TARGET_QUALITY = 50  # 压缩质量（1-100，数值越小压缩率越高）
   
9. MAX_WIDTH = 1024     # 最大宽度，超过则等比例缩放
   
10. SUPPORT_FORMATS = ('.jpg', '.jpeg', '.png', '.bmp')  # 支持的图片格式
    
11. 
    
12. def compress_image(file_path):
    
13.     """
    
14.     处理单张图片：缩放+压缩
    
15.     :param file_path: 图片文件的绝对路径
    
16.     :return: (是否成功, 原大小/KB, 新大小/KB, 错误信息)
    
17.     """
    
18.     try:
    
19.         # 获取文件原始大小
    
20.         original_size = os.path.getsize(file_path) / 1024  # 转KB
    
21. 
    
22.         # 打开图片（处理PNG透明通道问题）
    
23.         with Image.open(file_path) as img:
    
24.             # 1. 处理尺寸：宽度超过MAX_WIDTH则等比例缩放
    
25.             width, height = img.size
    
26.             if width > MAX_WIDTH:
    
27.                 ratio = MAX_WIDTH / width
    
28.                 new_height = int(height * ratio)
    
29.                 # 缩放图片（保留原图质量的缩放算法）
    
30.                 img = img.resize((MAX_WIDTH, new_height), Image.Resampling.LANCZOS)
    
31. 
    
32.             # 2. 处理压缩并保存（覆盖原文件，保持原格式）
    
33.             # 区分JPEG和PNG/BMP的保存参数
    
34.             file_ext = os.path.splitext(file_path)[1].lower()
    
35.             save_kwargs = {}
    
36.             if file_ext in ('.jpg', '.jpeg'):
    
37.                 # JPEG压缩：设置质量，关闭渐进式（加快加载）
    
38.                 save_kwargs['quality'] = TARGET_QUALITY
    
39.                 save_kwargs['optimize'] = True
    
40.                 save_kwargs['progressive'] = False
    
41.             elif file_ext == '.png':
    
42.                 # PNG压缩：优化压缩
    
43.                 save_kwargs['optimize'] = True
    
44.             elif file_ext == '.bmp':
    
45.                 # BMP无质量参数，仅缩放
    
46.                 pass
    
47. 
    
48.             # 保存图片（覆盖原文件）
    
49.             img.save(file_path, **save_kwargs)
    
50. 
    
51.         # 获取处理后文件大小
    
52.         new_size = os.path.getsize(file_path) / 1024
    
53.         return (True, original_size, new_size, "")
    
54.    
    
55.     except Exception as e:
    
56.         # 捕获异常并返回错误信息
    
57.         error_info = traceback.format_exc()[:200]  # 截取前200字符，避免信息过长
    
58.         return (False, 0, 0, error_info)
    
59. 
    
60. def batch_compress(root_dir):
    
61.     """
    
62.     批量处理指定目录下的所有图片（递归遍历子目录）
    
63.     :param root_dir: 目标根目录
    
64.     """
    
65.     # 第一步：收集所有符合条件的图片文件路径
    
66.     image_files = []
    
67.     for root, dirs, files in os.walk(root_dir):
    
68.         for file in files:
    
69.             file_ext = os.path.splitext(file)[1].lower()
    
70.             if file_ext in SUPPORT_FORMATS:
    
71.                 file_path = os.path.join(root, file)
    
72.                 image_files.append(file_path)
    
73.    
    
74.     if not image_files:
    
75.         print(f"⚠️  在目录 {root_dir} 下未找到任何支持的图片文件（{SUPPORT_FORMATS}）")
    
76.         return
    
77. 
    
78.     # 第二步：批量处理图片，显示进度条
    
79.     success_count = 0
    
80.     fail_count = 0
    
81.     total_original_size = 0  # 总原始大小（KB）
    
82.     total_new_size = 0       # 总处理后大小（KB）
    
83. 
    
84.     print(f"\n📌 共发现 {len(image_files)} 张待处理图片，开始批量压缩...\n")
    
85.     # 进度条配置：显示当前文件、进度、速度
    
86.     pbar = tqdm(image_files, desc="处理进度", unit="张", ncols=100)
    
87.     for file_path in pbar:
    
88.         # 更新进度条的当前文件提示
    
89.         pbar.set_postfix(file=os.path.basename(file_path))
    
90.         
    
91.         # 处理单张图片
    
92.         success, ori_size, new_size, error = compress_image(file_path)
    
93.         
    
94.         # 统计数据
    
95.         if success:
    
96.             success_count += 1
    
97.             total_original_size += ori_size
    
98.             total_new_size += new_size
    
99.         else:
    
100.             fail_count += 1
     
101.             # 失败时在进度条后标注错误
     
102.             tqdm.write(f"❌ 处理失败 {file_path}：{error}")
     
103.    
     
104.     # 第三步：输出统计结果
     
105.     pbar.close()
     
106.     print(f"\n✅ 处理完成！")
     
107.     print(f"   成功：{success_count} 张 | 失败：{fail_count} 张")
     
108.     print(f"   原始总大小：{total_original_size:.2f} KB | 压缩后总大小：{total_new_size:.2f} KB")
     
109.     if total_original_size > 0:
     
110.         compression_rate = (1 - total_new_size / total_original_size) * 100
     
111.         print(f"   整体压缩率：{compression_rate:.2f}%")
     
112. 
     
113. if __name__ == "__main__":
     
114.     # 检查命令行参数：需要传入目标目录路径
     
115.     if len(sys.argv) != 2:
     
116.         print("🔧 使用方法：python image_compress.py 目标目录路径")
     
117.         print("   示例：python image_compress.py /www/wwwroot/your_site/images")
     
118.         sys.exit(1)
     
119.    
     
120.     target_dir = sys.argv[1]
     
121.     # 验证目录是否存在
     
122.     if not os.path.isdir(target_dir):
     
123.         print(f"❌ 错误：目录 {target_dir} 不存在！")
     
124.         sys.exit(1)
     
125.    
     
126.     # 开始批量处理
     
127.     batch_compress(target_dir)

复制代码

使用说明：

打开宝塔的「终端」（或通过 SSH 连接服务器），执行以下命令安装依赖库：
pip install pillow tqdm

执行脚本：
执行以下命令（替换为你的图片目录路径）：
# 示例：处理 /www/wwwroot/你的网站域名/images 目录下的所有图片
python /www/image_compress.py /www/wwwroot/your_site/images