uni-app canvas截图不生效，主因是canvas未正确挂载或绘制未完成；需确保canvas-id匹配、type="2d"、宽高非零，并在onReady后调用draw+canvasToTempFilePath。
uni-app 里 canvas 截图不生效？先确认是否真在「当前视图层」操作
uni-app 的截图能力本质依赖原生渲染层，uni.canvasToTempFilePath 只能截取 canvas 元素内容，不能直接截屏整个页面。所谓“页面截图”，其实是把当前页面 DOM 结构（或关键区域）先绘制到 canvas 上，再导出图片。很多同学卡在这一步：点了按钮没反应、返回空路径、安卓黑屏——大概率是 canvas 没正确渲染或未触发绘制完成回调。
- 确保
canvas已挂载且宽高不为 0（可用v-if="canvasReady"控制渲染时机） - 使用
uni.createCanvasContext时传入的 canvas-id 必须与 template 中的canvas标签一致，且该标签不能被v-show隐藏（v-show会保留 DOM 但设display: none，导致 canvas 不可绘） - H5 端不支持
canvasToTempFilePath直接截原生 canvas，必须用canvas.toDataURL()+uni.downloadFile或 Blob 方式中转
微信小程序真机上截图空白？检查 type 和 fileType 参数
微信小程序要求 canvas 必须设置 type="2d"（基础库 2.19.1+），否则 canvasToTempFilePath 返回空文件；同时，fileType 必须显式指定为 "png" 或 "jpg"，不能省略或写成大写。
-
<canvas canvas-id="myCanvas" type="2d" />—— 缺少type="2d"是真机黑屏最常见原因 - 调用时必须传
fileType: 'png'，即使默认值是 png，某些低版本基础库仍会失败 - 安卓真机若截图尺寸过大（如超过 2000px 宽），可能因内存不足截出空白图，建议限制 canvas 宽高不超过 1242×2688（iPhone 14 Pro Max 屏幕尺寸的 2 倍）
如何把页面区域「画进」canvas？用 dom-to-image 不靠谱，改用 uni.createSelectorQuery
dom-to-image 在 uni-app 中无法工作：它依赖浏览器 DOM API，而小程序环境无标准 DOM，H5 环境又受限于跨域和样式隔离。真正可行的是用 uni.createSelectorQuery 获取目标元素位置和尺寸，再用 context.drawImage（需先用 uni.canvasGetImageData 或离屏 canvas 做像素级合成）——但更实际的做法是：只截取你明确控制的 canvas 内容，或用 web-view 内嵌页自行实现截图逻辑。
- 如果只是想保存某个
<view class="card">区域：给它加id="target"，用uni.createSelectorQuery().select('#target').boundingClientRect()获取 rect，再创建等尺寸 canvas 绘制内容（需提前将内容转为 image 或用自定义绘制逻辑） - 纯文本+简单样式的区域，可考虑用
ctx.fillText+ctx.setFontSize重绘，避免 DOM 依赖 - 含复杂组件（如 swiper、video、map）的区域无法被 canvas 捕获，只能截图前隐藏它们
保存图片到相册失败？注意 uni.saveImageToPhotosAlbum 的平台差异
调用成功不代表图片进了相册。iOS 要求用户已授权 camera 或 photos 权限（uni.getSetting 检查），Android 则需在 manifest.json 中声明 WRITE_EXTERNAL_STORAGE 权限（仅 Android 10 以下），Android 11+ 使用作用域存储，saveImageToPhotosAlbum 内部已适配，但路径必须是本地临时路径（tempFilePath）。
- 务必在
canvasToTempFilePath的 success 回调里立即调用saveImageToPhotosAlbum，不要存变量延迟执行（tempFilePath 有 24 小时有效期，但部分安卓机型几秒后就失效） - H5 端不支持
saveImageToPhotosAlbum，需降级为下载：location.href = tempFilePath或用a.download触发 - 微信小程序若提示 “fail no permission”，不是没点授权，而是首次调用前没用
uni.authorize({scope: 'scope.writePhotosAlbum'})主动申请（iOS 同理）
真正难的不是调哪个 API，而是接受 uni-app 没有「一键截屏」这个事实——每个平台的渲染机制不同，canvas 是唯一可控出口，其余都是绕路。别在「怎么让 div 变成图片」上死磕，从设计阶段就让要截图的内容走 canvas 渲染流，会省掉 80% 的坑。
