微信公众号自定义菜单支持在菜单名称旁展示一个小图标，这个功能看似简单，实际做起来坑不少。官方对图标的尺寸、格式、文件体积都有明确限制，一旦不符合要求，要么上传失败，要么在手机端显示得模糊发虚。设计师交付一张源图之后，往往还需要开发或运营手工导出各种规格，费时费力。与其反复手动处理，不如写一个自动化的图标输出工具，输入一张设计稿，自动生成全部符合规范的成品。本文从规范讲起，再一步步实现这个工具。
一、微信公众号菜单图标的官方规范要点
先明确目标。微信公众号自定义菜单的图标，当前主流要求是正方形图片，建议尺寸按官方文档为准，通常以像素为基准的小尺寸展示，手机上渲染区域非常有限。格式方面，公众平台一般接受PNG和JPG两种，其中PNG支持透明背景，是菜单图标的首选，因为菜单栏底色在不同主题下会变化，透明的PNG能保证图标不带着一块白色或黑色底板出现。
文件体积也有上限控制，通常单张图不能超过规定的大小（一般控制在几十KB以内最为稳妥）。这是很多团队容易忽略的一点：设计师直接导出的PNG往往有上百KB，虽然尺寸看着没问题，上传时却会被拒绝，或者在弱网环境下加载缓慢。此外还要注意图标的视觉留白，图标内容不要顶满整个画布，四周保留一定比例的安全边距，否则在小尺寸渲染时会显得拥挤，甚至和菜单文字贴在一起。
总结下来，输出工具需要满足三个硬性条件：第一，尺寸精确可控，能从一张大图缩放到目标小尺寸且保持清晰；第二，格式可同时输出PNG（透明）和JPG（不透明场景备份）；第三，输出后自动压缩，保证体积达标。这三个需求正好可以用Python配合Pillow库优雅地解决。
二、工具核心实现：基于Python与Pillow的尺寸缩放与格式转换
Pillow是Python生态里最成熟的图像处理库，缩放、格式转换、透明度处理都内置支持。先安装依赖：
pip install Pillow
工具的核心逻辑是：读取一张源图（建议设计师提供1024x1024或更大的正方形源文件），按照预设的尺寸列表逐一缩放，分别保存为PNG和JPG两套文件，并在保存时进行压缩控制。下面是核心代码：
from PIL import Image
import os
# 目标尺寸列表，可根据实际需求增减
TARGET_SIZES = [32, 48, 64, 96, 128]
def process_icon(source_path, output_dir):
# 打开源图并统一转为RGBA模式，保留透明通道
img = Image.open(source_path).convert("RGBA")
# 如果源图不是正方形，先居中裁剪为正方形
width, height = img.size
if width != height:
side = min(width, height)
left = (width - side) // 2
top = (height - side) // 2
img = img.crop((left, top, left + side, top + side))
os.makedirs(output_dir, exist_ok=True)
for size in TARGET_SIZES:
# 使用LANCZOS算法缩放，小尺寸下清晰度最好
resized = img.resize((size, size), Image.LANCZOS)
# 输出PNG（透明背景）
png_path = os.path.join(output_dir, f"icon_{size}x{size}.png")
resized.save(png_path, "PNG", optimize=True)
# 输出JPG时需要先铺白色底，否则透明区域会变黑
background = Image.new("RGB", resized.size, (255, 255, 255))
background.paste(resized, mask=resized.split()[3])
jpg_path = os.path.join(output_dir, f"icon_{size}x{size}.jpg")
background.save(jpg_path, "JPEG", quality=85, optimize=True)
print(f"已生成: {png_path} 和 {jpg_path}")
if __name__ == "__main__":
process_icon("source.png", "output")这段代码有几个细节值得展开。首先是convert("RGBA")，如果源图是JPG格式，转成RGBA后透明通道是全不透明的，不影响后续处理；如果源图本身是PNG带透明，通道会被完整保留。其次是缩放算法的选择，LANCZOS在缩小图像时能有效抑制锯齿，比默认的最近邻插值效果好很多，尤其在32像素这种极小尺寸下差别肉眼可见。最后是JPG输出的处理，JPEG格式不支持透明通道，直接保存透明PNG会被填充成黑色，所以代码里先新建了一张白色底的画布再把透明图贴上去，这是实际开发中最常见的坑之一。
圆角处理也是很多图标需要的。微信菜单本身是方形展示位，但设计上常用圆角矩形图标，可以用Pillow的遮罩功能实现：
def add_round_corner(img, radius_ratio=0.2):
size = img.size
radius = int(size[0] * radius_ratio)
# 创建圆角遮罩，抗锯齿开启
mask = Image.new("L", (size[0] * 4, size[1] * 4), 0)
from PIL import ImageDraw
draw = ImageDraw.Draw(mask)
draw.rounded_rectangle([0, 0, size[0] * 4, size[1] * 4], radius * 4, fill=255)
mask = mask.resize(size, Image.LANCZOS)
result = Image.new("RGBA", size, (0, 0, 0, 0))
result.paste(img, (0, 0), mask)
return result这里的技巧是把遮罩先放大四倍绘制再缩小回来，相当于手动做了超采样抗锯齿，圆角边缘会平滑得多。如果直接在小尺寸上画圆角，边缘会有明显的锯齿感。
三、体积压缩与质量校验：确保图标能顺利上传
尺寸和格式都对了，还差体积这一关。上面的代码中PNG用了optimize=True参数，JPG设置了quality=85，这在多数情况下已经够用。但如果源图色彩复杂，输出的PNG仍可能超标，这时可以进一步降低JPG质量参数，或者对PNG做调色板化处理：
def compress_png(img, output_path):
# 转为256色调色板模式，大幅减小体积，适合图标类图像
quantized = img.convert("RGB").quantize(colors=256, method=Image.MEDIANCUT)
quantized.save(output_path, "PNG", optimize=True)
def check_size(file_path, limit_kb=50):
size_kb = os.path.getsize(file_path) / 1024
if size_kb > limit_kb:
print(f"警告: {file_path} 体积为 {size_kb:.1f}KB，超出 {limit_kb}KB 限制")
return False
return True调色板化对照片类图像会有色阶损失，但菜单图标通常是简洁的线条或单色图形，256色完全够用，体积往往能压缩到原来的三分之一以下。需要注意调色板化会丢失透明通道，如果必须保留透明，就退回RGBA加optimize的方案，或者改用质量更低的JPG配合设计上的纯色背景。
更进一步，可以给工具加一个批量模式和可视校验：遍历整个目录的源图统一处理，处理完成后自动拼一张对比预览图，把所有尺寸的图标排在一起，方便设计师快速目检哪个尺寸下细节丢失严重。还可以用img.getbbox()检测图标内容是否顶满画布，如果内容边界距离画布边缘小于百分之五，就在日志里提示留白不足。
如果希望非技术人员也能使用，可以用PyInstaller把脚本打包成免安装的桌面小工具，或者用Flask包一层网页界面，做成本地上传、点击生成、打包下载的轻量服务。团队内共享一个这样的工具，比每个人各自开图像软件手动导出效率高得多，也避免了因个人操作差异导致图标规格不统一的問題。
最后再强调一次视觉层面的规范：小尺寸图标里不要塞过多细节，粗线条、高对比的设计在几十像素的展示位里才看得清。工具能保证技术指标合规，但图标的可读性还是要靠设计阶段的克制。把规范固化成自动化流程，把精力留给创意本身，这才是这类输出工具真正的价值。