Canvas设置文本font-weight时移动端不生效且ctx.font无法存储字重的求助
核心原因
移动端浏览器的Canvas 2D ctx.font解析存在明确的兼容性边界,和桌面端的渲染逻辑差异极大:
- 绝大多数旧版移动端浏览器(包括旧版移动Safari、安卓内置WebView、低版本移动端Chrome)的font解析器,仅能识别
normal、bold这类标准关键词字重,对100-900的数值型字重、bolder/lighter这类相对字重完全不支持。解析失败时不会抛出任何报错,会直接静默丢弃整个字重参数,你调试时观察到的ctx.font仅保留字号和字体名、丢失字重的现象,就是解析器丢弃不识别参数的直接表现,不是Canvas本身的逻辑bug。 - 开发者工具的响应式模式本质是调用桌面端渲染引擎模拟移动端视口尺寸,没有使用移动端的原生渲染栈,所以无法复现真实手机上的解析逻辑,自然测不出这个兼容性问题。
- 自定义字体如果没有提前在页面CSS里明确加载对应粗度的字体文件,移动端浏览器在Canvas绘制时不会自动匹配自定义字体的字重效果,会直接回退到系统默认常规字重。
可落地的修复方案
ctx.font赋值时,严格按照移动端可识别的shorthand语法书写,不要使用数值字重、相对字重值,仅保留bold作为字重关键词。- 不要在页面加载完成后立刻执行Canvas绘制逻辑,必须等待自定义字体完全加载完成后再绘制,避免字体未就绪导致字重匹配失败,参考写法如下:
async function main() { // 等待所有页面字体加载完成 await document.fonts.ready ctx.drawImage(img, 0, 0, size, size); ctx.font = "bold 110px 'Saira Condensed', sans-serif"; ctx.textAlign = "center"; ctx.fillStyle = "#ffffff"; ctx.fillText(number, 325, 290); } - 你当前代码已经使用了
bold作为字重关键词,如果仍不生效,优先检查对应字体的加载逻辑:确认粗体版本的字体文件是否在绘制Canvas前完成加载,是否在CSS的@font-face规则里给这个字体文件标注了对应字重属性。 - 如果需要呈现900的超粗字重效果,不要依赖浏览器自动合成粗体(移动端Canvas的文字合成粗体效果粗糙,且很多WebView不支持该能力),需要单独加载对应字重的字体文件,让Canvas绘制时能直接匹配到正确的粗体字体资源。
- 部分老旧安卓WebView场景下,如果仍无法显示粗体,可通过多次偏移绘制文本模拟粗体效果,作为兜底方案。
内容的提问来源于stack exchange,提问作者foodles
相关产品推荐
相关产品推荐

