uni-app中image组件在微信小程序真机上无法触发@longpress，须改用view+background-image模拟；调用showActionSheet前需校验平台权限，且items不得超过6项。
uni-app 长按图片触发 showActionSheet 的核心限制
uni-app 的 image 组件默认禁用长按识别（尤其在微信小程序平台），直接绑定 @longpress 事件在真机上大概率不触发——这不是代码写错了，而是微信小程序底层对 image 的原生行为拦截所致。必须绕过原生 image，改用 view + background-image 模拟图片容器，才能稳定捕获长按。
用 view 替代 image 实现可长按的图片容器
关键点在于放弃语义化 image 标签，改用带背景图的 view，并手动设置宽高和背景尺寸：
-
view必须显式声明width和height（不能依赖内容撑开） - 背景图使用
background-image: url(...)，且需加background-size: cover或contain控制缩放 - 添加
user-select: none防止 iOS 上误触发文字选择 - 绑定
@longpress时建议加touch-start防止误触，例如：@touchstart.stop="" @longpress="onLongPress"
<view
class="qrcode-bg"
@touchstart.stop=""
@longpress="handleLongPress"
></view>
.qrcode-bg {
width: 200rpx;
height: 200rpx;
background-image: url('/static/qrcode.png');
background-size: contain;
background-repeat: no-repeat;
background-position: center;
user-select: none;
}
showActionSheet 调用前必须校验平台和权限
微信小程序中 showActionSheet 无法直接识别图片内容，它只是弹出菜单；真正“识别小程序码”需调用 uni.scanCode（仅支持相机扫码）或服务端解析。常见误区是以为 showActionSheet 能触发识别——它不能。你只能用它提供「保存图片」或「识别此码」两个选项，后者需额外跳转到自定义识别页或调用后端 API：
- 微信小程序真机必须先调用
uni.authorize({scope: 'scope.writePhotosAlbum'})才能保存图片 -
showActionSheet的items数组长度不能超过 6 个，否则报错errCode: -1 - 安卓真机上若未配置
mp-weixin.permission，点击「保存」会静默失败，无提示
handleLongPress() {
uni.showActionSheet({
itemList: ['保存图片', '识别小程序码'],
success: (res) => {
if (res.tapIndex === 0) {
this.saveImageToAlbum();
} else if (res.tapIndex === 1) {
uni.navigateTo({ url: '/pages/scan/scan' }); // 自建扫码页
}
}
});
}
真机调试时长按没反应？重点检查这三处
90% 的“长按无效”问题集中在以下三个硬性条件，缺一不可：
- 微信开发者工具需开启「启用右键模拟长按」，真机调试必须用 iOS 设备（Android 微信对
longpress支持极差） - 页面
json中未配置"mp-weixin": { "permission": { "scope.writePhotosAlbum": { "desc": "用于保存小程序码" } } }，会导致后续保存失败且无明确报错 - 图片资源路径错误（如用了相对路径
./static/xxx.png），background-image加载失败时view为空，自然无法触发长按
复杂点在于：iOS 和 Android 对 longpress 的触发阈值、手势容错、与 touchmove 的冲突处理完全不同，不要试图一套逻辑兼容双端。如果业务强依赖识别，优先走服务端 OCR 接口上传 base64 图片，比前端扫码更可控。
