pillow 的 `sizes` 参数在保存 ico 文件时并非直接“强制缩放”，而是基于源图像宽高比进行等比缩放并裁剪，因此非正方形图像会导致输出尺寸与预期不符；解决方法是预先将源图处理为正方形。
在使用 Pillow（v10.2.0+）生成多尺寸 ICO 图标时，开发者常误以为 sizes=[(16,16), (24,24), ..., (256,256)] 会严格生成完全匹配的正方形图标，但实际输出中却出现 (16,15), (24,23), (96,92) 等非正方形尺寸——这并非 Pillow 的 Bug，而是其 ICO 编码器的默认行为：它会对原始图像按比例缩放以适配每个目标尺寸，同时保持宽高比，并在必要时裁剪边缘（而非拉伸或填充），从而导致高度/宽度轻微失衡。
根本原因在于：ICO 格式规范要求每个图标帧为位图（BMP 子格式），而 Pillow 的 ICO 保存器在缩放时采用 Image.LANCZOS（高质量重采样） + 比例约束 + 居中裁剪策略。若原始图像非正方形（如常见的 256×244 PNG），则所有缩放结果均继承该宽高比，最终尺寸必然为 (w, round(w × h/w))，即 h ≈ w × (original_h / original_w)。
✅ 正确做法：确保输入图像为严格正方形。可通过以下任一方式预处理：
-
方案 1：填充成正方形（推荐）
使用 ImageOps.pad() 自动居中填充透明/白色背景（需 RGBA 模式支持透明）：
from PIL import Image, ImageOps
def make_square(img: Image.Image, fill_color=(255, 255, 255, 0)) -> Image.Image:
"""将图像填充为正方形，保持原始比例，透明背景（RGBA）或白底（RGB）"""
if img.mode != 'RGBA':
img = img.convert('RGBA')
return ImageOps.pad(img, (max(img.size),) * 2, method=Image.LANCZOS, color=fill_color)
# 示例用法
with Image.open("input.png") as src:
square_img = make_square(src)
sizes = [(16, 16), (24, 24), (32, 32), (48, 48), (64, 64),
(96, 96), (128, 128), (192, 192), (256, 256)]
square_img.save("output.ico", format="ICO", sizes=sizes, bitmap_format="bmp")-
方案 2：缩放后裁剪（适合图标设计场景）
若需严格控制构图，可先缩放到最大目标尺寸（如 256×256），再中心裁剪：
max_size = max(max(s) for s in sizes) # e.g., 256
img = img.convert("RGBA").resize((max_size, max_size), Image.LANCZOS)
# 可选：手动 crop 到精确比例（如 1:1）
left = (img.width - max_size) // 2
top = (img.height - max_size) // 2
img = img.crop((left, top, left + max_size, top + max_size))⚠️ 注意事项：
- bitmap_format="bmp" 是 ICO 的必需参数（Pillow ≥ 9.1.0），否则可能报错；
- quality=100 和 subsampling=0 对 ICO 无效（仅 JPEG/WebP 生效），可安全移除；
- Windows 资源管理器仅显示部分尺寸（如 16×16、32×32、48×48、256×256），但完整尺寸组仍会被系统读取用于高 DPI 场景；
- 验证 ICO 内容推荐使用命令行工具：identify -verbose output.ico | grep "Geometry"（ImageMagick）或 Python 中 Image.open().n_frames + 循环 seek() 检查每帧尺寸。
总结：Pillow 的 sizes 参数是“目标尺寸列表”，而非“强制变形指令”。要获得精准的正方形 ICO 图标组，必须保证输入图像为正方形——这是跨平台、可复现、且符合 Windows 图标设计规范的最佳实践。
