讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

Pillow ICO 保存时尺寸被自动缩放的问题解析与解决方案

夏强姑娘_3880

夏强姑娘_3880

发布时间:2026-02-05 11:26:22

|

321人浏览过

|

来源于php中文网

原创

Pillow ICO 保存时尺寸被自动缩放的问题解析与解决方案

pillow 的 `sizes` 参数在保存 ico 文件时并非直接强制使用指定尺寸,而是基于源图像长宽比进行等比缩放,导致实际生成的图标尺寸与预期不符;解决方法是确保输入图像是正方形,或预先缩放/填充为所需最大尺寸。

在使用 Pillow(v10.2.0+)生成多尺寸 ICO 图标时,开发者常误以为传入 sizes=[(16,16), (24,24), ..., (256,256)] 就能精确生成对应像素尺寸的图标条目。但实际行为是:Pillow 会对原始图像按比例缩放以适配每个目标尺寸,同时保持宽高比不变。因此,若原始图像非正方形(如常见的 256×244 PNG),缩放后得到的尺寸将不是整数对,而是近似值(如 (16, 15)、(24, 23)),正如你输出中 {'sizes': {(96, 91), (48, 46), ...}} 所示。

✅ 正确做法:预处理图像为正方形

ICO 格式规范要求各尺寸图标均为正方形,且 Windows 资源加载器也严格依赖此约定。Pillow 在内部调用缩放逻辑时,会以源图的最小边长为基准做等比缩放,从而导致非正方形输入必然产生非整数宽高比的输出。

以下为推荐的健壮实现:

from PIL import Image
from io import BytesIO

def create_ico_from_image(
    data: bytes,
    sizes: list[tuple[int, int]] = [
        (16, 16), (24, 24), (32, 32), (48, 48),
        (64, 64), (96, 96), (128, 128), (192, 192), (256, 256)
    ],
    fill_color: tuple[int, int, int] = (255, 255, 255)  # 透明背景建议用 (0,0,0,0),需转 RGBA
) -> bytes:
    with Image.open(BytesIO(data)) as img:
        # 1. 转换为 RGBA(保留透明度)
        if img.mode != "RGBA":
            img = img.convert("RGBA")

        # 2. 获取最大目标尺寸,用于裁剪/填充基准
        max_size = max(max(s) for s in sizes)

        # 3. 等比缩放到最大尺寸,再居中裁剪为正方形(推荐用于摄影类图)
        # 或:填充为正方形(推荐用于 Logo/图标类图)
        img_square = Image.new("RGBA", (max_size, max_size), fill_color)
        img_ratio = min(max_size / img.width, max_size / img.height)
        new_size = (int(img.width * img_ratio), int(img.height * img_ratio))
        img_resized = img.resize(new_size, Image.LANCZOS)

        # 居中粘贴到正方形画布
        offset = ((max_size - new_size[0]) // 2, (max_size - new_size[1]) // 2)
        img_square.paste(img_resized, offset, img_resized)  # 第三个参数启用 alpha 遮罩

        # 4. 保存为 ICO,指定 sizes
        output = BytesIO()
        img_square.save(output, format="ICO", sizes=sizes, bitmap_format="bmp")
        return output.getvalue()

# 使用示例
with open(r"c:\path\to\image.png", "rb") as f:
    ico_data = create_ico_from_image(f.read())

with open(r"c:\path\to\output.ico", "wb") as f:
    f.write(ico_data)

⚠️ 注意事项

  • bitmap_format="bmp" 是必须的:Windows ICO 解析器最兼容 BMP 子图像格式;省略可能导致部分尺寸丢失或显示异常。

    Biopython
    Biopython

    全面的分子生物学工具集。适用于序列操作、文件解析(FASTA/GenBank/PDB)、系统发育分析,以及通过 Bio.Entrez 以编程方式访问 NCBI/

    下载
  • 避免 quality=100 和 subsampling=0:这些参数对 ICO 无效(仅 JPEG/WebP 支持),Pillow 会静默忽略,无需传递。

  • 验证输出:可用命令行工具确认结果:

    # ImageMagick(推荐)
    identify -format "%wx%h\n" output.ico
    
    # 或 Python 中检查
    with Image.open("output.ico") as ico:
        print(ico.info.get("sizes", set()))
  • 透明度支持:确保源图含 Alpha 通道,并使用 "RGBA" 模式 + paste(..., mask=img) 实现无损透明边缘。

✅ 总结

Pillow 的 ICO sizes 参数本质是“生成一组按比例缩放的正方形图标”,而非“强行拉伸/裁剪至指定尺寸”。要获得精确 (N, N) 尺寸输出,唯一可靠方式是确保输入图像是正方形。通过预处理(缩放+填充/裁剪)统一输入形态,即可完全控制最终 ICO 中每个图标的宽高值,无需依赖外部 DLL 或 C# 工具——纯 Python 即可达成专业级图标生成效果。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3519

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3058

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1568

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2759

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3370

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1757

2023.08.10

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

2537

2023.08.28

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

5567

2023.08.30

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn