Canvas 文本字体必须通过 ctx.font 一次性设置完整 CSS 字体字符串,如 "24px Arial";中文字体名需加引号;单位须用 px;字号影响 textBaseline 对齐和渲染清晰度;需在绘制前设置且无 CSS 继承;Web 字体需显式等待加载完成。

Canvas 文本的字体大小和字族必须通过 ctx.font 一次性设置,不能只写字号或只写字体名,也不能用 ctx.fontSize 这类不存在的属性。
font 属性必须是完整 CSS 字体简写字符串
它不是多个独立属性,而是一整条字符串,格式严格类 CSS。最简有效形式是:
-
ctx.font = "24px Arial";(字号 + 单位 + 字体族) -
ctx.font = "bold 18px 'PingFang SC', 'Microsoft YaHei', sans-serif";(可加粗细、样式、多级回退) - 中文字体名含空格或特殊字符,必须用单引号或双引号包裹,否则 Safari/Chrome 会跳过该字体
- 单位必须带 px;
em、rem在 Canvas 中不生效;pt、cm虽语法合法但极少使用且兼容性差
字号影响渲染效果与布局定位
字体大小不只是“看起来多大”,还直接决定:
- fillText() 的垂直位置:默认
textBaseline = "alphabetic",y 坐标对齐小写字母 x 的底部,中文容易偏高甚至被截断 - 建议中文场景设为
ctx.textBaseline = "middle"配合ctx.textAlign = "center"实现视觉居中 - 小字号(≤12px)在普通屏上易发虚,高分屏下更明显,需配合 devicePixelRatio 缩放处理
设置时机和作用范围很重要
font 不是全局默认,而是上下文状态的一部分:
- 必须在调用
fillText()或strokeText()之前 设置,否则仍用浏览器默认的10px sans-serif - 一旦设置,后续所有文本绘制都沿用,直到你再次修改
ctx.font - 没有继承性:页面 CSS 的 font-size、font-family 对 Canvas 完全无效
- 如果用了
ctx.scale()或ctx.transform(),字体视觉大小也会被缩放,需注意坐标与字号的协同调整
中文显示要特别注意字体加载
用 Web 字体(如 Google Fonts 或自定义 @font-face)时:
- 不能依赖
window.onload,字体可能还没就绪,导致文字渲染成方块或 fallback 到系统字体 - 应显式等待:
await document.fonts.load("24px 'Noto Sans CJK SC'"); - 之后再执行
ctx.font = "24px 'Noto Sans CJK SC'";和fillText()
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











