必须用Canvas实现文字水印,uni.createCanvasContext是核心入口;直接在上叠加或cover-view不会被导出,真正生效的水印需通过Canvas 2D API写入像素层。

uni-app文字水印必须用Canvas,uni.createCanvasContext是核心入口
直接在<image></image>上叠加<text></text>或cover-view不会被导出——这是最常踩的坑。真正生效的水印只能通过Canvas 2D API绘制进像素层。关键不是“显示”,而是“写入图像数据”。
-
uni.createCanvasContext必须传入canvas-id字符串,且该id要与模板中<canvas></canvas>组件的canvas-id属性严格一致(大小写敏感) - H5/APP端需先将图片转为
base64再创建Image对象;小程序可直读tempFilePath - 务必调用
ctx.draw(false, callback)中的false参数,否则uni.canvasToTempFilePath可能截取空白画布
多行文字水印要手动算Y坐标,ctx.measureText不能省
自动换行不是Canvas内置能力,ctx.fillText只画单行。你要自己切分文本、逐行计算垂直位置,否则文字会重叠或溢出画布。
- 先用
ctx.measureText(text).width获取每行宽度,用于居中/右对齐时修正x偏移 - 行高不能只靠
fontSize,得加lineHeight补偿(例如fontSize * 1.3),否则中文行距过紧 - 起始
y建议从底部向上推:比如imgHeight - 20 - (lineIndex * lineHeight),避免文字被裁剪
uni.canvasToTempFilePath失败?检查这三处硬性限制
这个API在不同平台行为差异极大,失败往往不报具体错误,只返回空路径或静默失败。
- 画布
width/height必须是整数,且不能超过平台限制(iOS真机常见上限为2048×2048,超限直接返回tempFilePath: "") - 小程序要求
canvas-id必须在当前页面vue实例内定义,nvue页面不支持此API,需改用native-canvas - H5端必须确保Canvas已挂载到DOM,
createSelectorQuery().select()查不到节点时会卡住,建议加setTimeout延后执行
字体和清晰度问题:别信ctx.font = "14px sans-serif"
移动端Canvas默认字体渲染极糊,尤其小字号中文。这不是配置问题,是底层像素对齐缺陷。
- 安卓App端强制设
ctx.font = "normal normal 14px 'Microsoft YaHei'"比系统默认更稳 - iOS需配合
ctx.scale(dpr, dpr)缩放画布,但注意canvas.width/height也要同步乘dpr,否则文字发虚 - 透明度用
ctx.globalAlpha比fillStyle里写rgba()兼容性更好,尤其H5端
实际生成水印时,最易被忽略的是画布尺寸与设备像素比(dpr)的耦合关系——不处理dpr,iOS上文字边缘全是锯齿,安卓上则可能整体偏小。这一步没有捷径,必须读uni.getSystemInfoSync().pixelRatio并显式缩放。


















