canvasrenderingcontext2d实现像素级绘制需四步:适配设备像素比、全量或脏矩形清除、确保资源加载完成、用requestanimationframe驱动动画,缺一不可。

直接用 CanvasRenderingContext2D 就能干这事,但关键不在“能不能画”,而在“怎么画才不糊、不卡、不错位”。Canvas 的像素级控制能力是真实的,但默认行为会悄悄破坏它。
canvas.width 和 CSS width 混用会导致图像模糊
这是最常被忽略的像素失真源头。Canvas 的绘图表面由 width 和 height 属性(单位:像素)定义;而 CSS 的 width/height 只是拉伸显示区域,不改变实际分辨率。
- 错误写法:
<canvas width="400" height="300" style="width: 100%; height: auto"></canvas>→ 在 2x 屏上,400×300 像素被拉成 800×600 显示,所有线条变虚 - 正确做法:先读取
canvas.clientWidth和设备像素比window.devicePixelRatio,再重设canvas.width/canvas.height - 示例逻辑:
const dpr = window.devicePixelRatio || 1; const rect = canvas.getBoundingClientRect(); canvas.width = rect.width * dpr; canvas.height = rect.height * dpr; ctx.scale(dpr, dpr);
clearRect 不清全画布就留残影
动画或频繁重绘时,旧图形不会自动消失。只清局部区域极易漏掉边缘、拖尾、坐标偏移导致的残留。
- 安全兜底:每次重绘前执行
ctx.clearRect(0, 0, canvas.width, canvas.height) - 性能优化(仅限已知运动范围):计算“脏矩形”——上一帧与当前帧包围盒的并集,传入
clearRect(left, top, width, height) - 禁用技巧:
canvas.width = canvas.width虽能清屏,但会重置fillStyle、lineWidth、font等全部状态,需手动恢复
drawImage 加载未完成就调用会报错
常见错误信息:Failed to execute 'drawImage' on 'CanvasRenderingContext2D': The image argument is a canvas element with a width or height of 0. 根本原因是图片还没解码完,img.width 还是 0。
- 必须等
img.onload触发后再启动绘制循环,或用img.complete && img.naturalWidth > 0做双重校验 - 如果用
drawImage(img, sx, sy, sw, sh, dx, dy, dw, dh)做裁剪缩放,确保sx/sy不越界,sw/sh不为 0 - 动态雪碧图动画中,
sx = frameIndex * frameWidth必须在帧索引合法范围内,否则裁剪区无效
requestAnimationFrame 才是动画唯一可靠驱动源
用 setTimeout 或 setInterval 驱动 Canvas 动画,大概率卡顿、掉帧、不同设备节奏不一致。
-
requestAnimationFrame与屏幕刷新率同步(通常 60fps),且浏览器会在页面不可见时自动暂停,省电又稳定 - 必须在每一帧末尾递归调用:
function animate() { /* 绘制逻辑 */ requestAnimationFrame(animate); },漏掉这句就只跑一帧 - 避免在帧内做耗时操作:比如遍历万级数据、JSON.parse 大字符串、重复创建对象——这些都会挤占渲染时间,直接掉帧
像素级控制的真实门槛不在 API 多难,而在你是否主动管理了设备像素比、是否每次重绘都清干净、是否等资源就绪才动手、是否让动画节奏真正贴合屏幕。漏掉其中任一环,画出来的东西就不是“像素级”的了。











