Canvas在Retina屏模糊的根源是物理像素与CSS像素不匹配,需将canvas.width/height设为CSS尺寸×dpr,用CSS固定显示尺寸,并调用ctx.scale(dpr,dpr)保持逻辑坐标系,再配合lineCap、lineJoin及sub-pixel对齐优化渲染。

在 Retina 屏幕(或高 DPI 设备)下,Canvas 默认会因物理像素与 CSS 像素不匹配而出现模糊、锯齿或线条发虚。要绘制极致细腻的几何图形,关键不是“放大画布”,而是让 Canvas 的绘图分辨率与设备实际像素密度对齐,并保持坐标逻辑清晰、路径抗锯齿可控。
正确设置 canvas 的物理尺寸与显示尺寸
Canvas 模糊的根本原因是:HTML 的 width/height 属性定义的是绘图表面的逻辑像素数,而 CSS 的 width/height(或 style)控制的是它在屏幕上的显示尺寸(CSS 像素)。当设备像素比(window.devicePixelRatio)>1 时,若两者未按比例同步,就会拉伸渲染,导致失真。
- 获取设备像素比:
const dpr = window.devicePixelRatio || 1 - 读取父容器尺寸(如
canvas.parentElement.getBoundingClientRect()),得到期望的显示宽高(CSS 像素) - 将 canvas 的
width和height属性设为:Math.round(displayWidth * dpr)和Math.round(displayHeight * dpr) - 用 CSS 将 canvas 显示尺寸固定为
displayWidth × displayHeight(例如style="width:400px;height:300px;") - 最后调用
ctx.scale(dpr, dpr),使所有坐标单位(如fillRect(10,10,20,20))仍按逻辑像素书写,无需重写业务逻辑
开启高质量抗锯齿与平滑渲染
Canvas 默认启用抗锯齿,但某些操作(如硬边矩形、1 像素线)在高 DPI 下仍可能显毛刺。可通过上下文属性精细调控:
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
-
ctx.imageSmoothingEnabled = true(默认开启,确保缩放图像不生硬) -
ctx.lineCap = "round"或"square"替代默认"butt",避免线段端点露白点 -
ctx.lineJoin = "round"让折线拐角圆润,尤其对多边形轮廓和路径描边至关重要 - 绘制细线时,避免使用
lineWidth = 1;改用lineWidth = 1 * dpr并配合ctx.scale(dpr, dpr),等效于物理 1px 线
路径绘制时采用 sub-pixel 精度与贝塞尔优化
几何图形越复杂(如圆弧、椭圆、曲线多边形),越依赖路径采样精度。Canvas 的 arc() 和 ellipse() 在高 DPI 下本身已足够平滑,但需注意:
立即学习“前端免费学习笔记(深入)”;
- 避免整数坐标硬编码:用
x + 0.5对齐物理像素中心(如ctx.fillRect(Math.floor(x)+0.5, Math.floor(y)+0.5, w, h)),减少半像素偏移导致的模糊 - 绘制圆形/椭圆时,优先用
ctx.arc(x, y, r, 0, Math.PI*2),而非多个lineTo拼接——浏览器底层做了硬件加速的圆弧光栅化 - 对花瓣、螺旋等参数化曲线,采样点密度应随 dpr 提升:例如原计划 60 点画一圈圆,在 Retina 下可增至
Math.ceil(60 * dpr),再用bezierCurveTo或quadraticCurveTo连接,兼顾性能与顺滑度
避免常见陷阱
很多“高清失败”其实源于配置顺序或隐式重置:
- 不要在设置
width/height属性后,再通过 CSS 改变 canvas 尺寸——这会触发重采样拉伸 - 每次重设
width/height都会清空画布并重置所有上下文状态(包括fillStyle、lineWidth、scale),所以scale(dpr,dpr)必须在重设尺寸之后重新调用 - 慎用
ctx.clearRect(0,0,w,h)清屏:若 w/h 是逻辑尺寸,需确保它们已按 dpr 缩放;更稳妥是用ctx.setTransform(1,0,0,1,0,0); ctx.clearRect(0,0,canvas.width,canvas.height); - 矢量图标或文字若需极致清晰,可考虑用 SVG 替代 Canvas;Canvas 更适合动态生成、高频重绘的几何场景


















