最稳妥方案是使用 uni-cropper 库，配置 mode="circle" 即可原生支持圆形裁剪，适配 H5、App 和小程序，且避免手动 canvas 实现的像素对齐、EXIF 方向、跨端临时文件等兼容性问题。
uni-app 中用 cropper 组件实现圆形裁剪最稳妥
直接用现成的、专为 uni-app 优化的裁剪库，比自己封装 canvas 更可靠。目前社区主流是 uni-simple-picker 作者维护的 uni-cropper（注意不是同名但已停止维护的老版本），它原生支持圆形裁剪模式，且适配了 H5、App 和小程序平台。
安装后关键配置只有两个：mode="circle" 开启圆形裁剪，imgWidth/imgHeight 控制预览图尺寸（建议设为 300px 左右，避免高清图渲染卡顿）。
- 务必在
onLoad或用户选择图片后调用ref.cropper.setSrc(imagePath)设置源图，不能靠 props 直接传 —— 否则 H5 下可能不触发渲染 - 裁剪结果通过
@confirm拿到的是 base64 字符串，若需上传，建议先转成File或使用uni.uploadFile的filePath方式（需先用uni.getFileSystemManager().writeFile存临时文件） - 微信小程序真机调试时，如果提示
canvas is not defined，检查是否在manifest.json中开启了「微信小程序」的「增强编译」
自定义 canvas 裁剪时圆形遮罩怎么画才不糊
手动用 canvas 实现的核心是：先画一个圆形路径，再用 clip() 截取图像区域，最后 drawImage。但很多开发者发现裁出的边缘发虚，本质是像素对齐没处理好。
- canvas 宽高必须设为整数，且最好和目标输出尺寸一致（比如要裁 200×200 圆图，canvas 就设
width=200、height=200） - 画圆前调用
ctx.scale(1, 1)清除可能存在的缩放干扰（尤其在 iPhone X 等刘海屏上，uni-app 可能自动加了 scale） - 使用
ctx.arc(centerX, centerY, radius, 0, Math.PI * 2)画圆，centerX和centerY必须是整数，radius也尽量取整，避免 sub-pixel 渲染 - 裁剪后调用
canvas.toDataURL('image/png', 1)，第二个参数设为1强制最高质量，不要用默认值
uni-app 头像编辑功能里如何处理 iOS 图片方向异常
用户从相册选图后，在 iOS 设备上常出现旋转 90°/270°，这是因为 EXIF 信息里的 orientation 被忽略。uni-app 的 uni.chooseImage 默认不处理这个字段。
- 必须手动读取图片二进制数据并解析 EXIF —— 推荐用轻量库
exif-js（注意用npm install exif-js@2.3.0，新版已不兼容） - 拿到
exif.Orientation后，在 canvas 绘制前做对应旋转：比如 orientation=6 就顺时针转 90°，再调整 drawImage 的宽高参数顺序 - 更省事的做法：在调用
uni.chooseImage时传sizeType: ['compressed']，压缩后的图多数已修正方向（但仍有小概率失效，不能完全依赖）
裁剪完的头像怎么适配不同端的上传限制
H5、App、小程序对上传文件大小和格式容忍度差异很大：微信限制单文件 ≤ 5MB，H5 用 FormData 上传时 base64 过大会卡死，App 端又可能因系统权限无法访问临时路径。
- 统一策略：裁剪后立即压缩 —— 用
uni.compressImage（App/H5 支持）或canvas.toDataURL('image/jpeg', 0.8)（小程序可用）生成 JPEG，控制体积在 500KB 内 - 微信小程序必须用
tempFilePath上传，所以裁剪后得先uni.canvasToTempFilePath再uni.uploadFile；而 H5 可直接用fetch+Blob - App 端注意：Android 需动态申请
WRITE_EXTERNAL_STORAGE权限，iOS 则要确保Info.plist里配置了NSPhotoLibraryUsageDescription
圆形裁剪看着简单，真正跨端稳定运行的难点不在画圆本身，而在图片加载时机、EXIF 兼容、canvas 像素对齐和各端临时文件生命周期管理 —— 这些细节漏掉任意一个，都会导致某台手机上头像歪着、糊着或根本传不上去。
