真机调试是前提，canvas-id需与createcanvascontext参数一致，必须调用ctx.draw(true)并等待回调，导出仅支持png格式；关闭antialias、设置linecap为round可解决线条发虚；canvas宽高须用标签属性而非css设置，并乘dpr适配高清屏；保存相册前需申请writephotosalbum权限。
uni-app App端canvas手写签名导出图片失败？先确认canvasToTempFilePath是否在真机调用
App端（iOS/Android）的canvasToTempFilePath不能在开发工具里测，模拟器也不行——它依赖原生Canvas渲染管线，只有真机才能触发完整流程。常见错误是调试时看到“canvas is not defined”或导出路径为空，其实是uni.createCanvasContext返回的上下文没绑定到真实DOM节点，或者canvas-id没在<canvas></canvas>标签上正确声明。
- 必须用
<canvas canvas-id="signCanvas" class="canvas"></canvas>，且canvas-id要和uni.createCanvasContext('signCanvas')参数完全一致（区分大小写） - App端不支持
type: 'png'以外的格式，quality参数无效，别传 - 导出前务必调用
ctx.draw(true)并等待回调完成——App端draw是异步的，没等完就调canvasToTempFilePath会返回空文件
签名线条发虚、断点、延迟高？关掉antialias并改用lineCap: 'round'
App端Canvas默认开启抗锯齿，但会导致手写轨迹模糊、压感丢失、多点触控时线条断裂。尤其iOS真机上，touchmove事件频率不如Web高，如果每笔都重绘全图，延迟会明显。
- 创建context时加
{ antialias: false }：uni.createCanvasContext('signCanvas', { antialias: false }) - 画线前设置
ctx.setLineCap('round')和ctx.setLineJoin('round')，避免转角生硬、起笔露尖 - 别在
touchmove里反复ctx.draw()，只记录点坐标，松手后一次性重绘——否则iOS会卡顿，Android可能直接丢帧
导出图片空白或尺寸不对？检查canvas宽高是否被CSS拉伸
<canvas></canvas>标签的width和height属性是逻辑像素（device pixel ratio无关），而CSS的width/height是显示尺寸。App端若用style="width: 100%; height: 300px"拉伸canvas，实际绘制区域还是默认300×150，导出图必然变形或留黑边。
- 显式设置
<canvas width="750" height="400"></canvas>（单位是px，不是rpx） - 对应地，在JS里用
uni.getSystemInfo算出dpr，然后把触摸坐标乘以dpr再绘图，否则线条细得看不见 - 导出时指定
width/height必须和<canvas></canvas>标签属性一致，否则裁切或缩放不可控
保存到相册失败或提示“无权限”？uni.saveImageToPhotosAlbum需手动申请writePhotosAlbum
App端调用uni.saveImageToPhotosAlbum前，必须已获得writePhotosAlbum权限。iOS首次调用会弹窗，但Android（尤其8.0+）若没提前声明，会静默失败，控制台只报“fail no permission”。
- 在
manifest.json的“App模块配置”里勾选“相册”权限（对应Android的android.permission.WRITE_EXTERNAL_STORAGE） - 调用前先
uni.authorize({ scope: 'scope.writePhotosAlbum' })，捕获auth deny错误并引导用户去设置页 - 注意：iOS 14+要求在
info.plist里补充NSPhotoLibraryAddUsageDescription字段，否则直接拒绝——这个必须在HBuilderX里通过“manifest.json → App SDK配置 → iOS设置”添加
最常被忽略的是dpr适配和draw时机：App端Canvas不是“画完立刻能导”，必须等ctx.draw回调执行完，再调canvasToTempFilePath；而dpr没乘进去，签名在高端屏上就是一根几乎看不见的细线。
