Canvas 文本自动折行需按像素宽而非字数切分,须预设完整 font 字符串、逐字符 measureText 累加判断,优先标点后断行,支持省略号、多对齐及兜底机制。

Canvas 本身不支持自动折行,所有换行逻辑必须由开发者手动实现。核心不是“按字数切”,而是“按像素宽切”——尤其面对中英文混排、emoji、全角/半角字符、不同字体时,仅靠字符串长度或字节数截断必然出错。
预设字体并稳定测宽
measureText 的结果高度依赖 ctx.font 设置。未显式声明字体时,不同系统可能回退到不可控字体(如某些安卓机缺“微软雅黑”),导致宽度测量失真,断行错位甚至死循环。
- 务必在调用 measureText 前设置完整 font 字符串,例如:ctx.font = '14px "Microsoft YaHei", sans-serif'
- 中文字体建议带 fallback(如 sans-serif),避免缺失字体时渲染异常
- 同一 canvas 若需多字体混排(如标题加粗+正文常规),每次切换字体后都必须重新 measureText
逐字符累加 + 智能断点
把字符串转为 Array.from(str),可正确处理 emoji、代理对、中文标点等复杂字符。维护当前行字符串和累计宽度,边拼边测:
- 拼入下一个字符后,用 ctx.measureText(line + char).width 判断是否超限
- 未超则保留;超了就绘制当前行,新行从该字符开始(不是丢弃)
- 若单个字符宽度 > maxWidth(如超长 URL 或组合 emoji),强制单独成行,防止卡死
- 中文场景下,优先在标点后断行(如“,”、“。”、“?”),避免在“《”、“(”前断;英文则尽量保单词完整,遇空格/标点再回退断
提升可读性与容错细节
纯算法能跑通,但真实项目需要微调体验:
- 每行绘制前 .trim(),过滤原始文本中的首尾空白、换行符、缩进,避免多出空行
- 末行放不下时,用 line.slice(0, -1) + '…' 替代硬截断,并重测宽度确保省略号不溢出
- 对齐支持:左对齐直接 fillText;居中需计算每行实际宽度,x 偏移 = (maxWidth - lineWidth) / 2;右对齐同理
- 高频固定字体+文本场景,可预建 ASCII + 常用汉字宽度查表,减少重复 measureText 调用
封装成可复用绘图函数
把逻辑收拢为带参数的函数,调用更直观、易维护:
- 输入:ctx、文本、起始坐标 (x, y)、最大宽度、行高、对齐方式(左/居中/右)、是否显示省略号
- 输出:自动分行、逐行 fillText,支持垂直居中、两端对齐(通过字符间距微调)等常见布局
- 推荐扩展兜底机制:如连续 10 次断行失败,强制按字符数切分,避免无限循环


















