Canvas导出图片需解决跨域污染、格式参数、背景处理和下载逻辑:img加crossorigin="anonymous",服务端配CORS;PNG用"image/png",JPEG需"image/jpeg"+0.0–1.0质量值并填白底,WebP需兼容检测;下载应转Blob后用FileSaver.js或手动创建a标签触发。

网页端用 Canvas 导出多种格式图片,核心是 toDataURL() 方法配合背景处理、质量控制和下载逻辑。关键不在“能不能”,而在“怎么绕过污染、填好底色、选对参数、触发下载”。
先解决跨域污染——导出为空或黑图的根源
只要 drawImage 了一张没配 CORS 的图片(哪怕本地同目录 PNG),Canvas 就被污染,toDataURL() 会返回 "data:," 或纯黑图。
-
img 标签必须加
crossorigin="anonymous",例如:
- 服务端响应头必须包含
Access-Control-Allow-Origin: *(或具体域名) -
本地开发不能用 file:// 协议,必须起 HTTP 服务,比如:
python3 -m http.server 8000或npx http-server - 第三方图源不支持 CORS?只能走代理接口,前端无法绕过
按需导出 PNG / JPEG / WebP——参数和陷阱要分清
同一张 canvas,换 MIME 类型 + 合理参数,就能输出不同格式,但每种都有硬性要求:
-
PNG:只认
"image/png",第二个参数(如质量值)会被完全忽略 -
JPEG:必须传
"image/jpeg"+ 小数质量(0.0–1.0),例如canvas.toDataURL("image/jpeg", 0.85);0.855、85、"0.85"全部无效 -
WebP:支持透明、压缩率高,但 Safari 16.4 之前不支持;可用检测兜底:
canvas.toDataURL("image/webp").indexOf("data:image/webp") === 0 -
JPEG 不支持透明:PNG 转 JPEG 前,务必先填白底:
ctx.fillStyle = "#ffffff"; ctx.fillRect(0, 0, canvas.width, canvas.height);
把 Data URL 变成可下载文件——不靠后端
拿到 toDataURL() 返回的字符串后,不能直接赋给 @#@#@#@#@#@#@#@#@#@0,一行代码搞定:
- 先转 Blob:
const blob = await fetch(canvas.toDataURL("image/jpeg", 0.9)).then(r => r.blob()); - 再下载:
saveAs(blob, "my-chart.jpg"); - 它自动兼容 IE10+、Chrome、Firefox、Safari,体积小、无依赖、纯前端











