putImageData写回画布需确保同一ctx实例、正确坐标和colorSpace声明；data须按RGBA四元组处理并调用putImageData生效，大图宜用缓冲区一次性写入。
直接用 putImageData 把改好的像素数据写回画布，关键不是“能不能写”，而是“怎么写才生效”。它不走绘图状态（比如 globalAlpha 或混合模式），也不自动校验，写错坐标或数据格式就静默失败——画面看起来没变化，其实根本没写进去。
确保 ImageData 来源和目标一致
必须用同一个 CanvasRenderingContext2D 实例获取和写入：
- 用
ctx.getImageData(...)拿到的数据，就得用同一个ctx.putImageData(...)写回去 - 不能把 A 画布的
ctxA.getImageData()结果，传给 B 画布的ctxB.putImageData() - 用
new ImageData()构造时，现代浏览器（尤其 Safari）要求显式声明colorSpace: 'srgb'，否则拒绝写入
控制写入位置和范围
putImageData(imageData, dx, dy) 的 dx 和 dy 是目标区域左上角在画布上的坐标，不是偏移量：
- 想完整覆盖原图，就写
putImageData(data, 0, 0) - 若只处理了局部（比如从
(10, 10)开始取的 100×100 区域），写回时也要用putImageData(data, 10, 10)，否则会错位 -
dx或dy超出画布尺寸（如负数、大于canvas.width），操作静默失败，画面无反应
正确操作像素数组 data
imageData.data 是 Uint8ClampedArray，每个值自动被限制在 0–255：
立即学习“前端免费学习笔记（深入）”；
- 按每 4 个元素一组处理：索引
i对应 R，i+1是 G，i+2是 B，i+3是 A - 赋值时避免小数或负数：
data[i] = 256会被截成 255，data[i] = -10变成 0 - 修改完必须调用
putImageData，漏掉这一步，前面所有计算都白费
性能与安全建议
大图处理时别反复读写全图：
- 优先创建独立输出缓冲：
const out = ctx.createImageData(width, height)，边算边写进out.data，最后一次性putImageData(out, 0, 0) - 避免在循环里对每个像素调用
putImageData—— 它开销大，且只能整块写 - 超大图像可考虑
OffscreenCanvas+ Web Worker 离屏计算，主线程不卡顿
