把图片格式转换做进浏览器:HEIC、透明通道、ICO,以及"压缩完反而更大"
浏览器自带的图片能力,边界比大多数人想的要窄一点:<canvas> 只能导出 JPEG、PNG、WebP 三种格式,createImageBitmap 读不了 iPhone 拍的 HEIC,SVG 它直接拒绝。
而用户的需求是"随便什么图,转成随便什么格式"。
这篇讲我把这件事做进浏览器时遇到的六个具体问题。核心只有一句话:浏览器的解码和编码能力都不全,缺的部分得自己补。
一、解码:一条路径覆盖不了所有输入
最省事的写法是 createImageBitmap(file),但它有四个不够用的地方:
- 不认 HEIC(iPhone 默认格式);
- 不认 SVG;
- 不处理 EXIF 方向 —— 手机竖着拍的照片,像素是横的,靠 EXIF 里的 Orientation 标记告诉查看器转 90 度。canvas 不认这个标记,画出来就是躺倒的;
- 部分浏览器对
File直接传入支持不一致。
第 3 条有解,而且不用自己解析 EXIF:
const bitmap = await createImageBitmap(file, { imageOrientation: 'from-image' });
from-image 会让浏览器按 EXIF 把图像转正之后再交给你。这个参数救了我一整块代码 —— 本来打算自己读 APP1 段算旋转角度的。
第 2 条(SVG)只能退回 <img>:
async function decodeSvg(file) {
const url = URL.createObjectURL(file);
const img = new Image();
img.src = url;
await img.decode();
URL.revokeObjectURL(url);
return img; // 需要画到 canvas 上时直接 drawImage
}
<img> 和 ImageBitmap 在 drawImage 眼里是一样的,所以调用方不需要关心是哪个分支出来的。
第 1 条是独立的一节。
二、HEIC:为什么必须塞一个 2 MB 的 WebAssembly 进来
Chrome 和 Firefox 完全不解码 HEIC,Safari 只在自家生态里解。也就是说,浏览器里没有别的办法读 iPhone 照片,只能带一个 HEIF 解码器。
我用的是 libheif-js,编译好的 wasm 大约 2 MB。2 MB 对首屏来说是灾难,所以它的加载策略是:只有真的拖进一个 HEIC 文件时才下载。
let modulePromise = null;
async function loadDecoder() {
if (!modulePromise) {
modulePromise = import('libheif-js/libheif-wasm/libheif-bundle.mjs');
}
return modulePromise;
}
function isHeicFile(file) {
const type = (file.type || '').toLowerCase();
if (type.startsWith('image/heic') || type.startsWith('image/heif')) return true;
return /\.(heic|heif)$/i.test(file.name); // 有些选择器不给 MIME
}
两个细节值得说:
- Emscripten 打出来的包不能被 bundler 处理。它会自己拼 wasm 的路径,一旦被 webpack/turbopack 改写就找不到文件。所以要么用
import()动态引入并配置成 external,要么把产物单独放在静态目录、运行时按 URL 加载。我选的是前者,配webpackIgnore一类的注释跳过打包。 - 要按扩展名兜底。从某些系统的文件选择器拿到的
File.type是空的,只看 MIME 会漏。
三、编码:canvas 只管三种,剩下三种自己写
canvas.toBlob(cb, mime, quality) 实际只支持 image/jpeg、image/png、image/webp。传 image/bmp 或 image/gif 进去,浏览器会静默地返回 PNG —— 又是一个不报错、结果不对的地方。用户下载下来发现扩展名是 .bmp、内容其实是 PNG,很多软件打不开。
所以 BMP、GIF、ICO 三种得手写编码器。都不长:
- BMP:24 位未压缩,文件头 + 信息头 + 按行倒序的 BGR 像素,行尾按 4 字节对齐补零;
- GIF:单帧、最多 256 色,要做调色板量化 + LZW 压缩。这里只做静态图,动画不在范围内;
- ICO:容器格式,里面装的是若干张 PNG。
ICO 值得单独看,因为它是个"容器"而不是"一种像素格式"。
四、ICO 的容器格式:一个字段只有 1 字节
一个 ICO 文件的结构是:
6 字节文件头(reserved=0, type=1, count=N)
N × 16 字节目录项
紧随其后的若干张图片数据(现代 ICO 里就是 PNG 字节)
目录项里有两个坑:
尺寸字段只有 1 个字节。 它能表示 0–255,而 ICO 支持 256×256 —— 规范的做法是把 256 写成 0。写代码时如果直接 byte[0] = 256,会溢出成 0,恰好对;但如果你为了"安全"截断成 255,这个图标在 256 尺寸下就废了。显式写出来更清楚:
out[base] = entry.size >= 256 ? 0 : entry.size; // 宽
out[base + 1] = entry.size >= 256 ? 0 : entry.size; // 高
out[base + 2] = 0; // 调色板颜色数,0 表示真彩
out[base + 3] = 0; // 保留
view.setUint16(base + 4, 1, true); // color planes,固定 1
view.setUint16(base + 6, 32, true); // 每像素位数,32 表示带 alpha
view.setUint32(base + 8, entry.png.length, true); // 这张图的字节数
view.setUint32(base + 12, offset, true); // 在文件中的偏移
每张图的偏移量要自己算。 offset 从"文件头 + 全部目录项"之后开始累加,写错一个字节整份文件就废。
实际生成时我一次塞六个尺寸(16/32/48/64/128/256),因为不同位置取的尺寸不一样:浏览器标签页取 16,任务栏取 32 或 48,桌面快捷方式会挑最大的那个。只给一张 256 的话,小尺寸显示时会由系统缩放出模糊的边缘。
五、透明通道:转 JPEG 之前必须先铺底色
PNG 有 alpha 通道,JPEG 没有。把带透明的 PNG 画到 canvas 上再导出 JPEG,透明区域会变成黑色 —— 因为 canvas 的初始像素是 rgba(0,0,0,0),丢掉 alpha 之后剩下的就是黑。
正确做法是先铺一层底色,再画图:
const ctx = canvas.getContext('2d');
if (!spec.alpha) { // 目标格式不支持透明
ctx.fillStyle = options.background || '#ffffff';
ctx.fillRect(0, 0, canvas.width, canvas.height);
}
ctx.drawImage(source, 0, 0, canvas.width, canvas.height);
默认给白色,但界面上让用户能改 —— 深色底的 PNG 转 JPG 时,白底会显得很脏,得让他自己挑。
六、"压缩完反而更大",以及怎么压到指定体积
这是用户反馈最多的一条,而且是真实存在的现象:
一张已经压过的 JPEG,用 canvas 重新导出,很可能比原文件更大。
原因有两层:一是原文件可能是很老的编码器压出来的,或者已经被压过多次,重编码相当于再掉一次画质却不一定变小;二是有时候原图本身质量参数就很低(比如 0.6),你按 0.92 重新编码,字节数当然上去。
我的处理是编码完再比一次,变大就不替换:
const encoded = await encodeOnce(canvas, spec, quality);
if (encoded.size > originalBytes) {
return { ...result, keptOriginal: true }; // 保留原文件,界面上明确告诉用户
}
界面上会给这类文件标一句"原图更小,已保留原图"。不标的话用户会以为工具坏了 —— 又一个"不报错但结果反直觉"的地方。
另一个功能是「压到指定 KB」。做法是从用户给的质量起点开始二分搜索,而且只往下调:
let low = 0.2, high = quality;
let best = firstTry; // 先试用户给的质量
if (best.size <= targetBytes) return best; // 已经够了就不动它
for (let i = 0; i < 6; i++) { // 6 次足够收敛,再多收益很小
const mid = (low + high) / 2;
const candidate = await encodeOnce(canvas, spec, mid);
if (candidate.size <= targetBytes) {
best = candidate;
low = mid; // 够了,试着再提高质量
} else {
high = mid;
}
}
只往一个方向搜是关键:如果允许往上调,用户要"不超过 200 KB",你可能会给出一个 199 KB 但画质比原图还差的版本,纯属自找。
小结
这六条有个共同的模式:浏览器的默认行为都不报错。
- 传
image/bmp给toBlob得到 PNG; - 画带透明的图到 canvas 得到黑底;
- 重编码之后文件变大;
- ICO 的 256 写成 255,只在 256 尺寸下坏。
处理办法不是记住这些坑,而是给每一步都加一条可断言的输出:编码完检查 MIME 真的是不是 BMP、字节数是不是比原文件小、ICO 解回来能不能数出六个条目。
这些东西合起来就是我在做的一个全部在浏览器里跑的在线工具箱,图片这块支持 JPG / PNG / WebP / AVIF / GIF / BMP / SVG / HEIC 输入,输出 JPG / PNG / WebP / BMP / GIF / ICO,一次 30 张,也能按指定 KB 或者指定尺寸来:
https://moying.xin/zh/tools/image-compress
没有上传接口,所有处理在 canvas 上完成,断网也能用。想看有没有偷偷传文件,打开 Network 面板拖一张进去就知道了。
站是我自己做的,代码细节上有说得不对的地方欢迎指出。

浙公网安备 33010602011771号