Canvas渲染模糊的根本原因是未适配高DPI屏幕的devicePixelRatio(dpr),需手动设置canvas元素的width/height属性为逻辑尺寸×dpr,并在绘图前调用ctx.scale(dpr,dpr),同时导出时指定destWidth/destHeight为逻辑尺寸×dpr。

Canvas drawImage 渲染模糊的根本原因
不是 uni-app 本身的问题,而是 Canvas 在高 DPI 屏幕(如 iPhone、安卓高端机)上默认用 1:1 像素绘制,但设备物理像素密度是 2x 或 3x —— 你画的是 300×400 的 canvas,实际渲染占了 600×800 物理像素,浏览器自动插值拉伸,结果就是发虚。
关键判断:只要海报文字/线条边缘有“毛边”“锯齿感”或“像被糊了一层”,基本就是没处理 dpr(devicePixelRatio)。
- uni-app 的
canvas组件不自动适配 dpr,必须手动缩放 canvas 的width/height属性和 CSS 样式 -
ctx.scale(dpr, dpr)必须在所有绘图操作前调用,且不能只缩放一次就完事——每次清空重绘都要重设 - 图片资源本身分辨率不足(比如只提供 1x 图),再怎么缩放也救不回来;需确保加载的是 @2x/@3x 图或 SVG
uni.createCanvasContext 后必须重设 canvas 像素尺寸
很多人只改了 CSS 宽高,忘了 canvas 元素的 width 和 height 属性才是决定绘图缓冲区分辨率的关键。CSS 控制显示大小,属性控制实际像素数。
正确做法是:先读取 uni.getSystemInfoSync().pixelRatio,再动态设置 canvas 节点的 width 和 height 属性(注意:不是 style!),最后用 ctx.scale() 对齐。
- 在
onReady钩子中获取 canvas 节点:uni.createSelectorQuery().select('#myCanvas').fields({ node: true, size: true }).exec(...) - 拿到 node 后,用
node.width = width * dpr、node.height = height * dpr(width/height是你期望的逻辑尺寸) - 然后调用
ctx.scale(dpr, dpr),之后所有坐标、字号、线宽都按逻辑尺寸写,不用乘 dpr - 如果 canvas 是响应式(比如全屏海报),每次尺寸变化都要重新 setAttribute 并重置 ctx
drawImage 加载远程图片时的跨域与清晰度陷阱
用 ctx.drawImage() 直接画 https://xxx.png,常见两个问题:一是 CORS 报错导致图片空白,二是图片被浏览器降采样(尤其 iOS WebView)。
uni-app 中,uni.downloadFile + canvas.drawImage 是更可控的路径,能绕过跨域限制,也能确保原始像素完整载入。
- 不要直接传 url 给
drawImage;先用uni.downloadFile下载到本地临时路径,再用uni.getImageInfo获取真实宽高(含 orientation 修正) -
getImageInfo返回的width/height是原始像素值,绘图时要按逻辑尺寸缩放比例换算,例如:目标区域宽 300px,dpr=3,图片原始宽 1200px → 绘制宽度应为1200 / dpr = 400,再配合ctx.scale(dpr, dpr)就刚好填满 300px 显示区 - iOS 真机下,
drawImage对 base64 图片支持不稳定,优先走临时文件路径 - 避免用
ctx.drawImage(img, sx, sy, sw, sh, dx, dy, dw, dh)做任意缩放——非整数倍缩放极易糊,尽量让dw/dh接近原始尺寸 / dpr
toTempFilePath 导出高清图的隐藏参数
canvas.toTempFilePath 默认输出的是逻辑尺寸图(比如你设 canvas.width=300,导出就是 300px 宽),不是物理像素图。想导出 600×900 的高清海报,必须显式传参。
这个 API 的 quality 和 destWidth/destHeight 是关键,但文档里藏得深,且不同平台行为不一致。
-
destWidth和destHeight指最终图片的**物理像素宽高**,不是 CSS 显示宽高;设成300 * dpr才能得到高清效果 -
quality只在 Android 生效(iOS 固定为 1.0),建议设0.95平衡体积与清晰度 - H5 端不支持
toTempFilePath,要用canvas.toDataURL,此时需手动指定image/jpeg和质量参数,且注意 base64 过长可能触发内存警告 - 真机调试时,务必检查导出路径是否可写(Android 10+ 需
android:requestLegacyExternalStorage="true")
事情说清了就结束。最常漏掉的是:改了 canvas.width/height 却忘了同步重设 ctx 的 transform;或者导出时用了 destWidth 却没按 dpr 缩放逻辑尺寸——这两处一错,海报就永远糊着。

















