uni.previewImage是目前UniApp中实现多图预览最稳定、跨端兼容性最好、无需额外依赖的方案，但需注意current参数类型与urls严格匹配、HTTPS链接强制要求、H5跨域限制及长按保存的平台权限差异。
直接说结论：uni.previewImage 是目前 UniApp 中实现多图预览最稳定、跨端兼容性最好、无需额外依赖的方案，但必须注意 current 参数传值方式、URL 协议一致性、以及 H5 端的跨域限制。
为什么 current 传索引或 URL 都可能出问题？
很多开发者发现预览时“总跳到第一张”或“点第 3 张却显示第 1 张”，根源就在 current 的类型和 urls 内容匹配逻辑上：
- 如果
current传的是字符串（如'https://a.com/1.jpg'），它必须严格等于urls数组中某一项的完整字符串 —— 包括大小写、编码、末尾斜杠等，否则 fallback 到第 0 项 - 如果
current传的是数字（如2），它代表索引位置，但 App 平台在 1.9.5–1.9.8 版本中是必填项，不填会直接报错；而小程序平台对重复 URL 有自动去重逻辑，可能导致索引偏移 - 当
urls中存在重复链接（比如同一张图被 push 了两次），用 URL 作为current会始终定位到第一次出现的位置，用索引则更可控
urls 数组里的链接必须是 HTTPS 吗？
不是“必须”，但实际项目中几乎必须 —— 尤其在 H5 和小程序环境：
- H5 端：HTTPS 页面加载 HTTP 图片会被浏览器主动拦截，控制台报
Mixed Content错误，图片空白 - 微信/支付宝/抖音小程序：要求所有资源使用 HTTPS，HTTP 链接调用
uni.previewImage会静默失败（fail回调可能不触发） - 本地路径（如
/static/xxx.jpg或uni.chooseImage返回的tempFilePaths）在 App 和小程序可用，但 H5 不支持 —— 所以跨端项目里，建议统一转成 base64 或走后端代理
长按保存功能在安卓/iOS 表现不一致怎么办？
longPressActions 看似简单，但权限、回调作用域、平台差异让它很容易失效：
- iOS 需要在
manifest.json的ios.permissions下声明PHPhotoLibrary，否则点击“保存图片”无响应，也不报错 - 安卓 10+（API 29+）默认禁止应用直接写入外部存储，
uni.downloadFile+uni.saveFile路径需指定为uni.env.USER_DATA_PATH或使用uni.getFileSystemManager()写入沙盒 -
success回调里的this指向容易丢失，尤其在 Vue 2 项目中，推荐提前缓存：const that = this，再在回调里调用that.saveImage(url) - 微信小程序不支持
longPressActions，该参数会被忽略 —— 如果需要统一长按菜单，得自己封装手势监听 + 自定义弹窗
性能敏感场景下，原生 API 和 @dcloudio/vue-image-preview 怎么选？
别只看功能多不多，先看你的图片数量和用户设备：
- 预览 ≤ 5 张普通尺寸图（uni.previewImage。实测内存占用低 30%~50%，启动更快，iOS 滑动更顺滑
- 需要展示图片描述、带 loading 占位、支持双指缩放控制、或要接入下载统计埋点 —— 选
@dcloudio/vue-image-preview。但它引入后包体积增加约 120KB，且在低端 Android 机上预览 10 张 4K 图时，内存峰值可能突破 380MB，容易触发系统回收 - 关键提醒：插件的
style.css必须显式引入，否则指示器、关闭按钮等样式丢失，这不是 bug，是设计使然
真正容易被忽略的点是：预览前没校验 URL 是否可访问。网络图片可能 404、重定向、或返回非图片 MIME 类型，uni.previewImage 不做预检，直接打开空白页。建议在调用前用 uni.getImageInfo 做轻量探测，失败则降级提示。
