图片压缩脚本使用说明

一、脚本简介

本脚本是一个用于将指定图片文件压缩到接近目标大小（以KB为单位）的Python程序。它支持JPEG格式的图片，并通过二分法不断调整图片的压缩质量，以达到尽可能接近目标大小的效果。

技术支持与交流

• GodModel生态应用交流群：加入我们的用户交流群
• 天神大模型能力接入文档：查阅官方文档
• 邮箱：3469807212@qq.com
• 作者：陈祖豪

二、运行环境

• 操作系统：Windows、macOS、Linux等支持Python环境的操作系统。
• Python版本：Python 3.x（建议使用Python 3.6及以上版本）。
• 依赖库：Pillow（PIL的一个分支和友好替代品）。

三、安装依赖

在运行脚本之前，需要确保已经安装了Pillow库。如果尚未安装，可以使用以下命令进行安装：

pip install pillow

四、使用方法

1. 打开命令行：

   • 在Windows上，可以使用命令提示符（CMD）或PowerShell。
   • 在macOS或Linux上，可以使用终端（Terminal）。

2. 运行脚本：

   • 在命令行中输入以下命令，并替换<输入图片路径>、<输出图片路径>和<目标大小(KB)>为实际的值：

     python compress_image.py <输入图片路径> <输出图片路径> <目标大小(KB)>
     

   • 例如，要将名为input.jpg的图片压缩到500KB，并保存为output.jpg，可以使用以下命令：

     python compress_image.py input.jpg output.jpg 500
     

3. 等待压缩完成：

   • 脚本将开始压缩图片，并在完成后打印出最终的质量、目标大小和实际大小。

五、注意事项

1. 输入图片路径：

   • 确保输入的图片路径是正确的，并且图片文件存在。
   • 如果路径中包含空格或特殊字符，请使用引号将路径括起来。

2. 输出图片路径：

   • 确保输出的图片路径所在的目录具有写入权限。
   • 如果输出路径中的目录不存在，脚本将不会自动创建它。

3. 目标大小：

   • 目标大小应设置为合理的值。过小的目标大小可能导致图片质量严重下降，甚至无法达到要求。
   • 脚本将尽可能接近目标大小，但可能无法完全匹配。

4. 图片格式：

   • 脚本主要处理JPEG格式的图片。如果输入的图片是其他格式，脚本将尝试将其转换为JPEG格式进行压缩。

5. 异常处理：

   • 如果在压缩过程中发生错误，脚本将打印出错误信息。请检查输入参数和文件路径是否正确。

六、示例

假设有一个名为example.jpg的图片文件，想要将其压缩到300KB并保存为compressed_example.jpg，可以按照以下步骤操作：

1. 打开命令行。

2. 输入以下命令：

   python compress_image.py example.jpg compressed_example.jpg 300
   

3. 等待脚本运行完成，并查看输出结果。

希望这份使用说明能帮助您更好地使用本图片压缩脚本！