Canvas裁剪缩放需用drawImage的9参数形式,分清源图裁剪区域(sx,sy,sWidth,sHeight)与目标绘制区域(dx,dy,dWidth,dHeight),缩放比由dWidth/sWidth和dHeight/sHeight隐含决定,dx/dy为画布绝对坐标,配合devicePixelRatio适配高清屏。

Canvas 中裁剪图片时的缩放与偏移量计算,核心是分清“源图裁剪区域”和“目标绘制区域”两套坐标系,不能混用。drawImage 的 9 参数签名才是裁剪+缩放的正确入口,5 参数只能缩放、不能裁剪。
裁剪缩放必须用 9 参数 drawImage
调用形式为:ctx.drawImage(img, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight)。前 4 个参数定义从原图哪一块取内容(裁剪),后 4 个决定这块内容画到画布上的位置和大小(缩放+定位)。
- sx/sy:裁剪起点,单位是原图像素,从左上角 (0,0) 开始算
- sWidth/sHeight:裁剪区域宽高,也按原图像素计;若超出原图尺寸,会自动截断
- dx/dy:这块裁剪内容在画布上的左上角位置(像素坐标)
- dWidth/dHeight:这块内容最终被拉伸/压缩成多大,即缩放后的目标尺寸
缩放比例和偏移要分开理解
缩放比不是直接写死的数字,而是由两组尺寸比值隐含决定:dWidth / sWidth 是横向缩放因子,dHeight / sHeight 是纵向缩放因子。dx/dy 不受缩放影响,它始终是画布上的绝对像素位置。
- 想把原图中间 200×200 区域放大 2 倍铺满 400×400 区域?设
sx = (img.width - 200)/2,sy = (img.height - 200)/2,再传dWidth=400, dHeight=400 - 想让裁剪区域居中显示在画布某点 (cx, cy),可算出 dx = cx - dWidth/2,dy = cy - dHeight/2
- 常见错误:把原图宽高直接当 sWidth/sHeight 传,结果裁了整张图;或把缩放后的尺寸误当 sWidth/sHeight,导致只显示左上角一丁点
配合 translate 或 scale 时务必 save/restore
如果先调用了 ctx.translate(100, 50) 或 ctx.scale(1.5, 1.5),后续所有 drawImage 的 dx/dy 和 dWidth/dHeight 都会被变换影响——dx 变成 100 + dx×1.5,dWidth 变成 dWidth×1.5。
立即学习“前端免费学习笔记(深入)”;
- 推荐做法:裁剪缩放逻辑尽量只靠 drawImage 参数控制,避免用全局变换
- 非用不可时,用
ctx.save()包住变换和绘制,再用ctx.restore()清除影响 - 调试可用
console.log(ctx.getTransform())查看当前矩阵是否为单位阵
设备像素比适配别漏掉
若 canvas 经过高清屏缩放(如 window.devicePixelRatio = 2),但没设置 canvas 的实际 width/height 属性,drawImage 渲染会模糊,尤其非整数缩放比时更明显。
- 创建 canvas 时,设
canvas.width = canvas.clientWidth * devicePixelRatio,canvas.height = canvas.clientHeight * devicePixelRatio - 再用 CSS 控制 canvas 元素显示大小(如
width: 100%; height: auto;) - 此时 drawImage 中的 dx/dy/dWidth/dHeight 仍按 CSS 像素写,浏览器自动映射到高分屏缓冲区



















