Canvas不提供“一键模糊”滤镜,需用getImageData获取像素数组,对每个像素取3×3邻域RGB值求平均(忽略alpha),写入新ImageData后putImageData绘制;跨域图须设crossOrigin="anonymous"。

Canvas 本身不提供“一键模糊”滤镜(如 CSS 的 filter: blur()),但可以通过图像数据操作实现简单的边缘模糊特效,核心是使用 getImageData + 像素邻域加权平均(即均值模糊/盒式模糊)。
用 getImageData 实现基础边缘模糊
这是最可控、兼容性好、适合轻量模糊(如 1–3px 柔边)的方法:
- 调用
ctx.getImageData(0, 0, width, height)获取原始像素数组(RGBA,每4个值一组) - 对每个目标像素,取其周围 3×3(或 5×5)邻域像素的 R/G/B 值,计算平均值(忽略 alpha 或单独处理)
- 将新值写入新
ImageData对象,再用ctx.putImageData()绘出 - 注意:需在同源图像上操作;若跨域图片需设置
crossOrigin="anonymous"
简化版代码示例(3×3 均值模糊)
以下函数对整个 Canvas 区域做一次轻度模糊:
function applySimpleBlur(ctx, radius = 1) {
const { width, height } = ctx.canvas;
const imageData = ctx.getImageData(0, 0, width, height);
const data = imageData.data;
const tempData = new Uint8ClampedArray(data.length);
<p>const r = radius;
for (let y = 0; y < height; y++) {
for (let x = 0; x < width; x++) {
let rSum = 0, gSum = 0, bSum = 0, count = 0;
// 遍历邻域 [x-r, x+r] × [y-r, y+r]
for (let dy = -r; dy <= r; dy++) {
for (let dx = -r; dx <= r; dx++) {
const nx = x + dx, ny = y + dy;
if (nx >= 0 && nx < width && ny >= 0 && ny < height) {
const idx = (ny <em> width + nx) </em> 4;
rSum += data[idx];
gSum += data[idx + 1];
bSum += data[idx + 2];
count++;
}
}
}
const idx = (y <em> width + x) </em> 4;
tempData[idx] = rSum / count;
tempData[idx + 1] = gSum / count;
tempData[idx + 2] = bSum / count;
tempData[idx + 3] = data[idx + 3]; // alpha 不变
}
}</p><p>const newImageData = new ImageData(tempData, width, height);
ctx.putImageData(newImageData, 0, 0);
}更高效的选择:用 CSS filter 临时叠加(非 Canvas 原生,但实用)
如果只是需要视觉柔边(比如按钮 hover 模糊、图层过渡),可绕过像素操作:
- 将 Canvas 封装进一个
<div> 容器中<li>对该容器应用 <code>filter: blur(1px)(支持 Chrome/Firefox/Safari/Edge) - 注意:此法会模糊整个 Canvas 元素(含文字、线条),且无法精确控制仅模糊边缘
- 优点是零 JS 计算、GPU 加速、性能极高,适合 UI 层级柔化
- 模糊前确保 Canvas 已绘制完成,否则读取的是空白数据
- 高 DPR 设备需先适配分辨率,否则模糊效果在 Retina 屏上会失真(建议先执行 DPR 缩放逻辑)
- 多次模糊会明显降质,单次 radius=1~2 足够;如需更强效果,改用高斯模糊(需预计算权重核)
-
文字模糊慎用,均值模糊易导致字形发虚;对文字建议优先用
ctx.imageSmoothingEnabled = false配合整数坐标+DPR 适配来保锐度
进阶提示:避免常见坑
实际使用时要注意几个关键细节:


















