Canvas裁剪必须配合save()和restore()实现状态隔离:先save()保存当前状态,再beginPath()+路径方法定义裁剪区,调clip()激活,绘图后restore()还原裁剪状态;漏掉save()会导致restore()无效或报错,clip()仅作用于当前路径而非已绘制图形。

Canvas 裁剪区域(clipping path)必须配合 save() 和 restore() 使用,否则裁剪状态会持续影响后续所有绘制,无法自动“退出”。关键不是“画个矩形就能裁”,而是要先保存原始状态、建立裁剪、绘图、再还原——整个过程是状态隔离,不是图像擦除。
裁剪前必须 save(),否则 restore() 无效
裁剪路径属于绘图上下文的可保存状态之一。但 clip() 本身不触发保存,它只是基于当前路径设置一个生效的裁剪区。如果你没在 clip() 前调用 save(),那之后调用 restore() 就找不到对应的上一个状态,要么没效果,要么报错(栈空异常)。
- 正确顺序:
ctx.save(); ctx.rect(x, y, w, h); ctx.clip(); ... 绘图 ... ctx.restore(); - 错误写法:
ctx.rect(x, y, w, h); ctx.clip(); ctx.restore();→ 报 DOMException 或无实际恢复
裁剪区域只能用路径定义,不能用 fillRect/strokeRect
clip() 依赖的是当前路径(current path),不是已绘制的图形。所以定义裁剪范围时,必须用 rect()、arc()、moveTo()+lineTo() 等路径构造方法,且不能调用 fill() 或 stroke() —— 否则路径被消耗,clip() 就没东西可裁了。
- ✅ 可行:
ctx.beginPath(); ctx.rect(50, 50, 200, 150); ctx.clip(); - ❌ 无效:
ctx.fillRect(50, 50, 200, 150); ctx.clip();(此时路径为空,裁剪无作用)
restore() 恢复的是裁剪状态,不是像素内容
restore() 只把裁剪路径还原到 save() 那一刻的值(比如“无裁剪”或上一个裁剪区),它不会重绘、不擦除、也不恢复已画的像素。也就是说,你在裁剪区内画的内容依然留在画布上,只是之后的绘制又回到完整画布区域了。
- 举例:先
save()+ 裁剪右半区 → 画红色圆 →restore()→ 再画蓝色方块 → 方块会完整显示在整个画布,不受之前裁剪限制 - 注意:如果想清掉裁剪区内的旧内容,得手动
clearRect(),和save/restore无关
嵌套裁剪需多层 save/restore 配对
你可以连续 save() 多次,每次 clip() 定义不同区域,restore() 会按后进先出(LIFO)逐层弹出。比如外层裁剪大框、内层再裁小圆,用两次 save() 就能分层控制。
- 典型结构:
save() → clip(大矩形) → save() → clip(小圆形) → 绘图 → restore() → 绘图 → restore() - 漏一次
restore(),后面所有绘制都会被最内层裁剪限制;多一次则栈空报错
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











