App端canvas局部截图需用uni.createCanvasContext创建上下文，通过drawImage从主canvas复制指定区域到离屏canvas，所有坐标尺寸须乘pixelRatio换算为逻辑像素，且iOS要求离屏canvas宽高属性严格匹配目标像素尺寸。
uni-app App端canvas局部截图为什么总截不到内容
因为 canvas 在 App 端（尤其是 iOS）必须用 uni.createCanvasContext 创建上下文，且不能直接操作原生 canvas DOM；更关键的是：**局部截图必须通过 drawImage 从另一个离屏 canvas 中“复制”指定区域，而不是靠 clip() 或 CSS 裁剪**。
常见错误现象：ctx.draw() 后 uni.canvasToTempFilePath 返回空白图、黑图，或只截到 canvas 左上角一小块。
- App 端不支持
canvas.getContext('2d')，必须用uni.createCanvasContext('myCanvas', this) - 目标区域坐标和尺寸单位是「逻辑像素」，不是 rpx 或物理像素，需用
uni.getSystemInfoSync().pixelRatio换算 - 离屏 canvas 的宽高必须设为「目标区域实际像素尺寸 × pixelRatio」，否则模糊或裁切错位
怎么用 uni.createCanvasContext 截指定 x/y/w/h 区域
核心思路：先在主 canvas 绘制内容 → 创建同 pixelRatio 倍率的离屏 canvas → 用 drawImage 把主 canvas 的某一块“搬”过去 → 再从离屏 canvas 导出图片。
实操要点：
- 离屏 canvas 需动态创建：
const offCanvas = uni.createCanvasContext('offCanvas', this)，ID 不能和主 canvas 重复 -
drawImage的 9 参数形式必须用：drawImage(srcCanvasId, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight)，其中sx/sy是源 canvas 上要截的起点，sWidth/sHeight是要截的宽高 - 所有数值（sx/sy/sWidth/sHeight/dWidth/dHeight）都要乘以
pixelRatio，否则在 iPhone 上会偏移或缩放异常
示例片段（截主 canvas 中 x=50, y=80, w=200, h=150 的区域）：
const sys = uni.getSystemInfoSync()
const scale = sys.pixelRatio
const sx = 50 * scale
const sy = 80 * scale
const sw = 200 * scale
const sh = 150 * scale
const dw = 200 * scale // 目标宽高通常和源一致
const dh = 150 * scale
<p>// 假设主 canvas ID 是 'mainCanvas'
uni.canvasToTempFilePath({
canvasId: 'offCanvas',
success: res => console.log('截图路径：', res.tempFilePath)
}, this)</p><p>// 注意：必须在 draw() 回调里执行 canvasToTempFilePath
const offCtx = uni.createCanvasContext('offCanvas', this)
offCtx.drawImage('mainCanvas', sx, sy, sw, sh, 0, 0, dw, dh)
offCtx.draw(false, () => {
// 这里再调用 canvasToTempFilePath
})安卓 vs iOS 在 canvas 局部截图上的关键差异
iOS 更严格：离屏 canvas 必须显式设置宽高属性（style.width/style.height 不生效），且 canvasId 必须真实存在于 WXML 中；安卓相对宽松，但仍有兼容性陷阱。
- iOS 要求离屏 canvas 的
width和height属性值必须等于dWidth/dHeight（即目标像素尺寸），否则drawImage失败或返回空 - 安卓部分机型（如旧版华为）对
drawImage的srcCanvasId类型敏感——传字符串 ID 才行，不能传 canvas 实例 - App 端不支持
canvas.toDataURL()，只能走uni.canvasToTempFilePath，且该 API 在 H5 环境不可用，务必条件编译
建议统一用条件编译包裹截图逻辑：#ifdef APP-PLUS，避免 H5 报错。
保存截图到相册前容易漏掉的一步
很多人调完 uni.canvasToTempFilePath 就直接 uni.saveImageToPhotosAlbum，结果在 iOS 上静默失败——因为 iOS 要求临时文件路径必须是本地沙盒路径，而 tempFilePath 默认可能是 http 或 base64，必须先用 uni.getFileSystemManager().readdir 或直接判断路径前缀确认是否合法。
- 检查
tempFilePath是否以file://开头，否则需用uni.downloadFile先拉取再保存 - iOS 需提前申请权限：
uni.authorize({scope: 'scope.writePhotosAlbum'})，且仅首次弹窗，失败后不会重试 - 安卓部分厂商（如小米）需要额外声明
android.permission.WRITE_EXTERNAL_STORAGE，并在 manifest.json 中配置
最稳妥做法：无论平台，都加一层 uni.getFileInfo 校验路径有效性，再进保存流程。
局部截图这事，难点不在代码长短，而在每一步的像素单位、canvas 生命周期、平台行为差异都得对得上。少换算一次 pixelRatio，就可能白忙十分钟。
